Skip to content

Payout detail

GET /v1/partners/payouts/{id}

One payout, as it stands right now.

Permissionread-gateway
Answers200, or 404
GET /v1/partners/payouts/8a21…
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx
x-partner-signature: <hmac-sha256 of the raw body, hex>

Same shape as the create call, with the current status. A failed payout carries failure_code.

{
"data": {
"id": "8a21…",
"reference": "PGW-8A21C4…",
"status": "succeeded",
"is_final": true,
"amount": "500000.0000",
"fee": "5000.0000",
"net_amount": "495000.0000",
"currency": "IDR",
"bank_code": "BRI",
"bank_account_number": "888801000157508",
"created_at": "2026-09-03T07:10:00.000Z",
"finalized_at": "2026-09-03T07:12:00.000Z"
},
"request_id": "req_…"
}
statusis_finalMeansYour balance
pendingfalseSent, or the outcome is not yet establishedStill reserved
succeededtrueThe transfer settledSpent
failedtrueThe provider refused. failure_code says whyReturned

Branch on is_final, not on the status name.

A payout can sit pending longer than you expect. That is deliberate: an outcome Moria cannot establish keeps your money reserved rather than releasing it twice.

Another partner’s id answers 404, not 403.

  • Webhookspayout.succeeded and payout.failed save you the polling