Initiate payout

POST https://api.balampay.com/sandbox/v1/virtual-accounts/{id}/payout

Send funds from a virtual account to a recipient's bank account via WIRE or SWIFT transfer. Supports two modes:

Fiat Payout (no payment_instructions):

• Debits the VA balance
• Queues a WIRE/SWIFT transfer to the recipient
• Requires sufficient balance to cover amount + fees
• Requires OTP verification: include a valid 6-digit code in the x-validation-header header (obtain via POST /verification/send)

Crypto Payout (with payment_instructions):

• Generates a single-use deposit wallet address
• Caller sends stablecoins to the address
• System converts to USD and initiates wire transfer
• supporting_documents are required
• Response includes deposit_instructions with wallet address and expiration
• OTP is not required

Prerequisites:

• Virtual account type must be US_BANK and status active
• Recipient must exist (type: WIRE or SWIFT)
• Mode cross-validation: fiat VA requires no payment_instructions, crypto VA requires payment_instructions

Tip: Use /payout/preview first to show fees before confirming.