Get Transaction Status

Retrieve the status and details of a specific transaction

Get https://dashboard.mbiyo.africa/api/v1/merchant/transactions/{transaction_id}

Headers

Authorization* string

Pass your merchant API key as a bearer token in the request header

Path Parameters

transaction_id* string

The unique transaction ID returned when the transaction was created

Example Request


curl -X GET "https://dashboard.mbiyo.africa/api/v1/merchant/transactions/TXN-1234567890ABCDEF" \
  -H "Authorization: Bearer YOUR_MERCHANT_API_KEY"

Success Response (200 OK)


{
  "status": "success",
  "message": "Transaction retrieved successfully",
  "data": {
    "transaction_id": "TXN-1234567890ABCDEF",
    "amount": 1000,
    "fee": 15,
    "currency": "XOF",
    "order_id": "ORDER-12345",
    "status": "successful",
    "type": "cashin",
    "payment_method": "mobile_money",
    "charged_amount": 1015,
    "created_at": "2025-12-16T10:30:00Z",
    "updated_at": "2025-12-16T10:35:00Z"
    "metadata": {
      "network": "mtn",
      "phone_number": "+22670123456",
      "country_code": "BF"
    }
  }
}

Error Response - Transaction Not Found (404)


{
  "status": "error",
  "message": "Transaction not found",
  "data": null
}

Response Fields

Field	Type	Description
transaction_id	string	Unique transaction identifier
amount	number	Transaction amount (without fees)
fee	number	Service fee charged
charged_amount	number	Total amount charged (amount + fee)
currency	string	3-letter ISO currency code
order_id	string	Your internal order reference
status	string	Transaction status: pending, successful, failed, cancelled
type	string	Transaction type: cashin (payin) or cashout (payout)
payment_method	string	Payment method used
created_at	string	Transaction creation timestamp (ISO 8601)
updated_at	string	Last update timestamp (ISO 8601)