Payouts - Axra

Payouts withdraw funds from an end-user’s wallet to an external destination. Axra routes to the optimal rail automatically based on the destination (bank, crypto, mobile money) and the destination currency.

Create a payout

curl -X POST https://api.useaxra.com/api/v1/treasury/payouts \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "partnerEndUserId": "eu_abc123",
    "partnerWalletId": "w_xyz",
    "amount": "100",
    "destinationType": "mobile_money",
    "destination": {
      "country": "NG",
      "accountNumber": "+2348000000000",
      "accountName": "Jane Doe",
      "networkName": "MTN"
    }
  }'

Sandbox payout outcomes

Control results in sandbox with metadata.test_outcome:

Value	Behavior
(none)	Completes after 2 seconds
`fail_insufficient_funds`	Fails immediately, reverses ledger
`delay_24h`	Completes after 24 hours

API Reference

See full endpoint documentation.