Skip to main content
Send a single payment to a saved beneficiary. Debits your wallet at the time of submission. 
POST https://api.yativo.com/api/v1/payout/simple
Requires Idempotency-Key header. Your wallet is charged immediately on submission.
​
debit_wallet
string
required
The source wallet currency to debit (e.g. "USD", "EUR").
​
amount
number
required
Amount to send in the debit wallet currency.
​
beneficiary_details_id
number
required
The saved beneficiary payment method ID (from POST /beneficiaries/payment-methods).
​
beneficiary_id
string
Optional beneficiary UUID for tracking.
curl -X POST 'https://api.yativo.com/api/v1/payout/simple' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: payout-simple-001' \
  -d '{
    "debit_wallet": "USD",
    "amount": 250,
    "beneficiary_details_id": 42
  }'

{
  "status": "success",
  "status_code": 200,
  "message": "Request successful",
  "data": {
    "transaction_id": "txn-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "processing",
    "amount": "250.00",
    "created_at": "2026-06-01T10:00:00.000000Z"
  }
}

{
  "status": "error",
  "status_code": 402,
  "message": "Insufficient wallet balance"
}