> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yativo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Single Payout

> Send one payment to a saved beneficiary payment method

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
```

<Note>
  Requires `Idempotency-Key` header. Your wallet is charged immediately on submission.
</Note>

<ParamField body="debit_wallet" type="string" required>
  The source wallet currency to debit (e.g. `"USD"`, `"EUR"`).
</ParamField>

<ParamField body="amount" type="number" required>
  Amount to send in the debit wallet currency.
</ParamField>

<ParamField body="beneficiary_details_id" type="number" required>
  The saved beneficiary payment method ID (from `POST /beneficiaries/payment-methods`).
</ParamField>

<ParamField body="beneficiary_id" type="string">
  Optional beneficiary UUID for tracking.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  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
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "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"
    }
  }
  ```

  ```json Insufficient balance theme={null}
  {
    "status": "error",
    "status_code": 402,
    "message": "Insufficient wallet balance"
  }
  ```
</ResponseExample>