Get Transaction Status

curl --request GET \
  --url https://api.cartevo.co/api/v1/payment/transactions/{transactionId}/status \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "message": "Transaction status retrieved successfully",
  "data": {
    "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "SUCCESS",
    "amount": 1000,
    "currency": "XAF",
    "phone_number": "237670000000",
    "country": "CM",
    "operator": "mtn",
    "type": "COLLECTION",
    "external_id": "ORD-2024-001",
    "reason": "Invoice payment",
    "description": "Payment collection transaction",
    "created_at": "2025-01-08T12:00:00.000Z",
    "updated_at": "2025-01-08T12:05:00.000Z",
    "error_message": "<string>"
  }
}

GET

payment

transactions

{transactionId}

status

Get Transaction Status

curl --request GET \
  --url https://api.cartevo.co/api/v1/payment/transactions/{transactionId}/status \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "message": "Transaction status retrieved successfully",
  "data": {
    "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "SUCCESS",
    "amount": 1000,
    "currency": "XAF",
    "phone_number": "237670000000",
    "country": "CM",
    "operator": "mtn",
    "type": "COLLECTION",
    "external_id": "ORD-2024-001",
    "reason": "Invoice payment",
    "description": "Payment collection transaction",
    "created_at": "2025-01-08T12:00:00.000Z",
    "updated_at": "2025-01-08T12:05:00.000Z",
    "error_message": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

transactionId

string<uuid>

required

Transaction UUID

Response

Transaction status retrieved successfully

success

boolean

Example:

true

message

string

Example:

"Transaction status retrieved successfully"

data

object

Show child attributes

data.transaction_id

string<uuid>

Example:

"550e8400-e29b-41d4-a716-446655440000"

data.status

enum<string>

Available options:

PENDING,

SUCCESS,

FAILED,

PROCESSING

Example:

"SUCCESS"

data.amount

number

Example:

1000

data.currency

string

Example:

"XAF"

data.phone_number

string

Example:

"237670000000"

data.country

string

Example:

"CM"

data.operator

string

Example:

"mtn"

data.type

enum<string>

Available options:

COLLECTION,

PAYOUT

Example:

"COLLECTION"

data.external_id

string

Example:

"ORD-2024-001"

data.reason

string

Example:

"Invoice payment"

data.description

string

Example:

"Payment collection transaction"

data.created_at

string<date-time>

Example:

"2025-01-08T12:00:00.000Z"

data.updated_at

string<date-time>

Example:

"2025-01-08T12:05:00.000Z"

data.error_message

string | null

Initiate Payout Query Transactions

⌘I

API documentation

Auth

Cards

Customers

Payment Collection

Webhook

Get Transaction Status

Authorizations

Path Parameters

Response