Get Status Payout by REF

Queries on Transactions

Get Status Payout by REF


6. payout_status_by_ref

Description:
Fetches the status of a payout using the Merchant's reference ID. This provides an easy and reliable way to confirm the outcome of transactions without needing additional details.
URL:

Request Parameters:

Parameter
Type
Description
service_code
String
Service code, e.g., BT_ARS.
reference
String
Merchant-provided reference ID.

Expected Response:

Field
Type
Description
status
String
Status of the request (success, error).
data.transaction_id
String
Unique transaction identifier.
data.status
String
Current transaction status, e.g., COMPLETED.
data.amount
Float
Amount associated with the transaction.

Example Request:

{ "service_code": "BT_ARS", "reference": "FOUT-T00000037" }

Example Response:

{ "status": "success", "data": { "transaction_id": "63ad7848-3672-422a-97df-2cb8ba25e11b", "status": "COMPLETED", "amount": 32.63 } }