Skip to main content
GET
/
api
/
v3
/
withdraw
/
status
/
{reference_id}
Get Withdrawal Mobile Money Status
curl --request GET \
  --url https://sandbox-api.kotanipay.com/api/v3/withdraw/status/{reference_id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "Withdrawal status retrieved",
  "data": {
    "id": "5f9b2c7b9c9d6b0017b4e6b1",
    "amount": 10,
    "walletId": "5f9b2c7b9c9d6b0017b4e6b1",
    "referenceNumber": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "transactionCost": 123,
    "transactionAmount": 123,
    "customerKey": "<string>",
    "integratorFeeAmount": 123,
    "integratorFee": 123,
    "errorMessage": "<string>",
    "callbackUrl": "https://example.com",
    "referenceId": "5f9b2c7b9c9d6b0017b4e6b1",
    "currency": "USD",
    "confirmationId": "<string>",
    "transactionError": "<string>",
    "telcoId": "<string>",
    "completed_at": "2023-11-07T05:31:56Z"
  }
}
This endpoint will return the status of the mobile money withdrawal request. The reference_id path parameter accepts either the Kotani platform reference ID or the telco/MNO transaction ID — whichever is available.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
reference_id
string
required

Response

​
success
boolean
Example:

true

​
message
string
Example:

"Withdrawal status retrieved"

​
data
object