Skip to main content
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:
ValueBehavior
(none)Completes after 2 seconds
fail_insufficient_fundsFails immediately, reverses ledger
delay_24hCompletes after 24 hours

API Reference

See full endpoint documentation.