POST

Get Payout Status

Retrieves the current status of a payout by its UUID. Use it to reconcile payouts after an HTTP 500 response — a 500 may or may not mean the payout was created, so always verify before retrying. State changes are also pushed to your callbackUri; polling is a fallback. See the Lifecycle States section below for the full set of values.

https://axiron.io/v2/payouts/status

Authenticate every request

Include your Bearer token and HMAC-SHA256 signature. Authentication guide →

Body parameters#

Required only

merchantIdstringrequired

Your merchant ID. The request will return 400 if omitted — the status lookup is always scoped to the merchant that owns the payout.

Example pay2p

payoutIdstring (uuid)required

The payout UUID returned in the create payout response

Example 2f106307-6251-497b-8684-c3af2e96e3f1

Payment lifecycle#

Read the state field to determine the payment outcome. The same states are delivered through callbacks.

pending

Initial state. The payout was accepted and queued for processing. Funds are reserved from your available balance but have not yet been transferred to the recipient bank.

canceledTerminal

Terminal state. The payout was rejected by the bank or canceled by Axiron (insufficient balance, invalid CBU, anti-fraud, etc.). Reserved funds are returned to your available balance. Safe to retry with a corrected request.

completedTerminal

Terminal success state. Funds were transferred and the bank confirmed receipt by the recipient. The callback fires exactly once on this transition.

Need help with your integration?Contact the team