Skip to main content
POST
/
api
/
payouts
Create Payout
curl --request POST \
  --url https://api.example.com/api/payouts \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transaction_type": "<string>",
  "payout_amount": 123,
  "source_amount": 123,
  "source_currency": "<string>",
  "payout_currency": "<string>",
  "recipient_id": "<string>",
  "bank_account": "<string>",
  "wallet_address": "<string>",
  "payment_method": "<string>",
  "payment_purpose": "<string>",
  "reference": "<string>"
}
'
{
  "id": "pay_abc123",
  "status": "pending",
  "created_at": "2026-03-01T10:00:00Z"
}
​
Authorization
string
required
Bearer token from Auth0
​
transaction_type
string
required
payout or swap
​
payout_amount
number
required
Amount in payout currency
​
source_amount
number
Amount in source currency
​
source_currency
string
required
Source currency code (e.g., “USD”)
​
payout_currency
string
required
Payout currency code (e.g., “MYR”)
​
recipient_id
string
required
Recipient ID
​
bank_account
string
Bank account number
​
wallet_address
string
Wallet address (for crypto payouts)
​
payment_method
string
required
Payment method (e.g., “fiat_bank_transfer”)
​
payment_purpose
string
Purpose of payment
​
reference
string
Payment reference
{
  "id": "pay_abc123",
  "status": "pending",
  "created_at": "2026-03-01T10:00:00Z"
}