Get payout by ID
Retrieves a single payout and its current status. Use this to poll a payout until it
reaches SUCCESS or FAILED.
Authorizations
API key for service-to-service or merchant authentication.
Headers
Unique identifier for request tracing. Generated by the client or server if not provided.
"550e8400-e29b-41d4-a716-446655440000"
Path Parameters
Unique identifier of the payout
"9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"
Response
Payout details.
A payout from an acceptance account to a settlement account
Unique payout identifier
"9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"
Payout accepted and funds held
"INITIATED"Acceptance account debited
"550e8400-e29b-41d4-a716-446655440000"
Settlement account credited
"4b0f6c1e-2d3a-4f5b-8c7d-9e0f1a2b3c4d"
Payout amount in minor units
x >= 1150000
Payout fee in minor units
x >= 0250
ISO 4217 currency code
"SAR"
Timestamp when the payout was created
"2026-09-29T10:00:00.000Z"
Timestamp of the last status change
"2026-09-29T10:00:00.000Z"
Merchant's own reference for the payout
"tiktok-payout-5531"
Reason the payout failed, set only when status is FAILED
null