Payouts

Validate the destination

Fetch the bank list before accepting a payout destination, then validate the account details before creating a withdrawal. This reduces bank-code and account-number mistakes and lets your user confirm the account name.

curl -X POST "https://api.example.com/api/confirm-bank-business" \
  -H "Content-Type: application/json" \
  -d '{"bank_code":"000013","number":"0480819436"}'

The response contains data.bank, data.name, and data.number. Display the resolved account name for confirmation, then submit the same bank code and account number when creating the withdrawal. Bank validation does not create a beneficiary or reserve funds.

Create and verify the withdrawal

Create a withdrawal with the validated destination details, then verify the one-time password sent to the merchant business email.