Get Payment
Retrieve a single payment by ID.
Authorizations
Stablepay API key. Include as Authorization: Bearer <key>.
Path Parameters
The pay_-prefixed payment ID.
Response
Payment found.
Prefixed ULID for this payment.
"pay_01HV8KZMRJPQR9S7T3XABCDEF"
Current state of the payment in the state machine.
initiated → provider_accepted → succeeded | failed | refunded
payout: issuer sends stablecoin → recipient receives fiat. payin: customer pays fiat → issuer receives stablecoin.
payin, payout The supported payment method used to deliver funds to the recipient.
BANK, MOMO, PAYBILL, TILL Stablecoin sent onchain for payment settlement.
USDC, USDT Total stablecoin amount charged.
"10.500"
Fiat amount the recipient receives.
"1350"
Fiat currency received by the recipient.
CDF, GHS, KES, NGN, TZS, UGX, XAF, XOF, ZAR, ZMW Provider's transaction ID. Null until the provider accepts.
"CC4SOjQu8UUarKaOGZy9"
Caller's own reference code (e.g. "csh-txn-20260506-001"). Stored as supplied in the payment request.
"csh-txn-20260506-001"
Machine-readable failure code (e.g. insufficient_funds or invalid_account). Null unless status is failed.
null
Human-readable description of why the payment failed. Null unless status is failed.
null
Money-in only. Bank account the customer must transfer fiat into to complete a bank payin.

