Payout detail
GET /v1/partners/payouts/{id}One payout, as it stands right now.
| Permission | read-gateway |
| Answers | 200, or 404 |
Request
Section titled “Request”GET /v1/partners/payouts/8a21…Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx-partner-signature: <hmac-sha256 of the raw body, hex>Response
Section titled “Response”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_…"}The statuses
Section titled “The statuses”status | is_final | Means | Your balance |
|---|---|---|---|
pending | false | Sent, or the outcome is not yet established | Still reserved |
succeeded | true | The transfer settled | Spent |
failed | true | The provider refused. failure_code says why | Returned |
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.
- Webhooks —
payout.succeededandpayout.failedsave you the polling