Disburse Funds

Send money from your Aurax wallet to a mobile money account. Use this for payouts, refunds, salaries, or any scenario where you need to push funds to a recipient.

⚠️Disbursements debit your Aurax wallet immediately. Ensure your wallet has sufficient balance before initiating.

POST

https://api.auraxpay.net/v1/payments/disburse

Requires payments.create permission

Request body

Parameter	Type	Required	Description
amount	integer	required	Amount in TZS. Minimum 1,000, maximum 5,000,000.
channel	string	required	Payout channel. One of: MPESA, AIRTEL_MONEY, TIGO_PESA, HALOPESA, BANK_TRANSFER
recipientPhone	string	required	Recipient phone in E.164 format. E.g. +255712345678
recipientName	string	required	Full name of the recipient. 1–100 characters.
description	string	optional	Reason for the payout. Max 500 characters.

Example request

cURL

curl -X POST https://api.auraxpay.net/v1/payments/disburse \
  -H "Content-Type: application/json" \
  -H "x-api-key: axp_live_YOUR_KEY" \
  -d '{
    "amount": 50000,
    "channel": "MPESA",
    "recipientPhone": "+255712345678",
    "recipientName": "John Mwangi",
    "description": "Weekly salary payout"
  }'

Node.js

"token-keyword">const res = "token-keyword">await fetch("token-string">'https://api.auraxpay.net/v1/payments/disburse', {
  method: "token-string">'POST',
  headers: {
    "token-string">'Content-Type': "token-string">'application/json',
    "token-string">'x-api-key': process.env.AURAX_API_KEY,
  },
  body: JSON.stringify({
    amount: 50000,
    channel: "token-string">'MPESA',
    recipientPhone: "token-string">'+255712345678',
    recipientName: "token-string">'John Mwangi',
    description: "token-string">'Weekly salary payout',
  }),
})

"token-keyword">const { transaction } = "token-keyword">await res.json()

Response

Response 201

{
  "success": true,
  "transaction": {
    "id": "txn_01j2k3m4n5p6q7r8s9t0",
    "reference": "AXP-DXYZW1A2",
    "type": "DISBURSEMENT",
    "amount": 50000,
    "fee": 0,
    "netAmount": 50000,
    "channel": "MPESA",
    "status": "PENDING",
    "recipientPhone": "+255712345678",
    "recipientName": "John Mwangi",
    "description": "Weekly salary payout",
    "createdAt": "2025-06-09T14: 30: 00.000Z"
  }
}

💡Listen for the payout.completed or payout.failed webhook to confirm final delivery status.