Payouts

curl -X POST 'https://api.yativo.com/api/v1/payout/simple' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Api-Secret: YOUR_API_SECRET' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: payout-simple-001' \
  -d '{
    "debit_wallet": "USD",
    "amount": 250,
    "beneficiary_details_id": 42,
    "customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
    "reference": "INV-2026-0042"
  }'

const response = await fetch('https://api.yativo.com/api/v1/payout/simple', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.YATIVO_API_KEY,
    'X-Api-Secret': process.env.YATIVO_API_SECRET,
    'Content-Type': 'application/json',
    'Idempotency-Key': `payout-simple-${Date.now()}`,
  },
  body: JSON.stringify({
    debit_wallet: 'USD',
    amount: 250,
    beneficiary_details_id: 42,
    customer_id: 'da44a3e6-eb5d-429f-8d17-357aa5a6cdf2',
  }),
});
const data = await response.json();

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

{
  "status": "failed",
  "status_code": 400,
  "message": "Insufficient wallet balance",
  "data": {
    "error": "Insufficient wallet balance"
  }
}

curl -X POST 'https://api.yativo.com/api/v1/payout/simple' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Api-Secret: YOUR_API_SECRET' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: payout-simple-001' \
  -d '{
    "debit_wallet": "USD",
    "amount": 250,
    "beneficiary_details_id": 42,
    "customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
    "reference": "INV-2026-0042"
  }'

const response = await fetch('https://api.yativo.com/api/v1/payout/simple', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.YATIVO_API_KEY,
    'X-Api-Secret': process.env.YATIVO_API_SECRET,
    'Content-Type': 'application/json',
    'Idempotency-Key': `payout-simple-${Date.now()}`,
  },
  body: JSON.stringify({
    debit_wallet: 'USD',
    amount: 250,
    beneficiary_details_id: 42,
    customer_id: 'da44a3e6-eb5d-429f-8d17-357aa5a6cdf2',
  }),
});
const data = await response.json();

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

{
  "status": "failed",
  "status_code": 400,
  "message": "Insufficient wallet balance",
  "data": {
    "error": "Insufficient wallet balance"
  }
}

Use POST /payout/simple to send a payment to one beneficiary. It requires a saved beneficiary with an attached payment method. See Beneficiaries for setting up beneficiaries.

All payout requests require an Idempotency-Key header. Your wallet balance is charged when the payout is submitted.

Single Payout

Send one payment to a saved beneficiary payment method.

POST https://api.yativo.com/api/v1/payout/simple

string

required

The wallet currency to debit, for example "USD".

number

required

Amount to send in the debit wallet currency.

number

required

The beneficiary id (from Add Beneficiary).

string

required

The customer the payout is for. If the beneficiary belongs to a customer, it must be that customer.

string

Optional. The beneficiary that owns the payment method.

string

Payment reference shown to the recipient’s bank, up to 250 characters. Some payout rails shorten it or remove unsupported characters.

/payout/simple also accepts quote_id, invoice and invoice_url, like POST /wallet/payout.

curl -X POST 'https://api.yativo.com/api/v1/payout/simple' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Api-Secret: YOUR_API_SECRET' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: payout-simple-001' \
  -d '{
    "debit_wallet": "USD",
    "amount": 250,
    "beneficiary_details_id": 42,
    "customer_id": "da44a3e6-eb5d-429f-8d17-357aa5a6cdf2",
    "reference": "INV-2026-0042"
  }'

const response = await fetch('https://api.yativo.com/api/v1/payout/simple', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.YATIVO_API_KEY,
    'X-Api-Secret': process.env.YATIVO_API_SECRET,
    'Content-Type': 'application/json',
    'Idempotency-Key': `payout-simple-${Date.now()}`,
  },
  body: JSON.stringify({
    debit_wallet: 'USD',
    amount: 250,
    beneficiary_details_id: 42,
    customer_id: 'da44a3e6-eb5d-429f-8d17-357aa5a6cdf2',
  }),
});
const data = await response.json();

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

{
  "status": "failed",
  "status_code": 400,
  "message": "Insufficient wallet balance",
  "data": {
    "error": "Insufficient wallet balance"
  }
}

List Payouts

Retrieve a paginated list of all your payouts.

GET https://api.yativo.com/api/v1/payout/get

curl -X GET 'https://api.yativo.com/api/v1/payout/get' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Api-Secret: YOUR_API_SECRET'

Get Single Payout

GET https://api.yativo.com/api/v1/payout/fetch/{payout_id}

string

required

The UUID of the payout to retrieve.

curl -X GET 'https://api.yativo.com/api/v1/payout/fetch/txn-a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Api-Secret: YOUR_API_SECRET'

Payout vs. Wallet Payout

	`POST /payout/simple`	`POST /wallet/payout`
Beneficiary required	Yes — `beneficiary_details_id`	Yes — `payment_method_id` + `customer_id`
Quote support	No	Yes — pass `quote_id` for locked rate
Fix the receive amount	No	Yes — `amount_type: "receive"`
Use case	Disbursements to saved beneficiaries	Single cross-currency payments with rate lock

For a single payment where you want to lock a rate first, use POST /exchange-rate (with method_type: "payout") → POST /wallet/payout. To fix what the customer receives rather than what you send, see Pay out by receive amount.

Get Started

Payments

Wallets

Customers & Compliance

Transactions

Products

Developer Tools

SDKs

Regional Guides

Platform guides

Single Payout

List Payouts

Get Single Payout

Payout vs. Wallet Payout

​Single Payout

​List Payouts

​Get Single Payout

​Payout vs. Wallet Payout

Single Payout

List Payouts

Get Single Payout

Payout vs. Wallet Payout