Get a disbursement
GET /v1/disburse/{reference} — check whether a disbursement landed.
/v1/disburse/:referenceDisburseReturns the current state of one of your payouts. Scoped to your own account — another
merchant's reference comes back as 404, not 403, so nobody can probe whether a
reference exists.
Request
curl https://connect.tchokopay.com/v1/disburse/PO-1787962449863-7B361B \
-H "Authorization: Bearer tchoko_live_..."Response
200 OK
{
"reference": "PO-1787962449863-7B361B",
"status": "SENT",
"amount": 25000,
"currency": "XAF",
"phone": "670000000",
"recipientName": "Amina Njoya",
"merchantReference": "payout_4417",
"providerReference": "MMH17797898332",
"awaitingReview": false,
"statusReason": null,
"createdAt": "2026-08-29T01:34:09.863Z"
}Status values
| Status | Means | Your money |
|---|---|---|
PENDING | Accepted and funded. Either queued to go out, or waiting for review. | Reserved |
SENT | Handed to the network, which accepted it. Not yet confirmed delivered. | Reserved |
PAID | Landed. The recipient has it. | Gone |
FAILED | The network didn't complete it. | Still reserved |
REJECTED | Declined during review. | Back in your balance |
SENT is not PAID. The network accepting a disbursement and the recipient
receiving it are two different events, sometimes minutes apart. Treat SENT as in
flight; wait for PAID before telling anyone the money arrived.
A FAILED disbursement keeps your money reserved — it is not returned automatically.
We confirm with the network whether the money actually moved before releasing it, and
then either complete it or return it to your balance. You get a disburse.failed webhook
either way. Do not re-send a failed disbursement yourself; contact us instead.
Errors
| Status | Meaning |
|---|---|
401 | Missing, invalid, or revoked API key. |
403 | Your key doesn't have the Disburse permission. |
404 | No payout with that reference on your account. |