Bank / E-wallet Transfer

Bank / E-wallet Transfer lets partners pay to a bank account, an e-wallet or mobile-money number, a PIX or Bre-B key, or a till/paybill number instead of a scanned QR. The entry point is POST /lookupPaymentCode, which creates a PENDING transaction (same shape as decodeQr). Downstream flow is unchanged: lookupPaymentCode → getQuotation → executePayout. Sender identity always comes from the registered customer_id — do not send sender.

Flow

POST /lookupPaymentCode with the typed destination. This validates the destination and creates a PENDING transaction (same shape as decodeQr).
POST /getQuotation with the returned tx_id and the amount.
POST /executePayout with a fresh X-Idempotency-Key header.

The destination itself never carries an amount; the amount is set at quotation time.

Request fields

Field	Required	Notes
`country_code`	yes	See the table below
`payment_destination`	yes	The typed destination: key, phone, or account number
`payment_method`	yes	Fixed per country, see below
`payment_destination_code`	some countries	See notes per country
`customer_id`	yes	Registered customer; sender identity always comes from it

Destinations by country

Country	`payment_method`	`payment_destination`	Notes
Philippines (PH)	`bank_transfer`	Mobile number for a wallet, account number for a bank	`payment_destination_code`: the `bank_list_code` from `listBanks?country_code=PH` (wallets such as GCash and Maya are listed alongside banks); `recipient.name` required
Indonesia (ID)	`ewallet` or `bank_transfer`	Phone number of the wallet, or a 6–30 digit bank account number	E-wallet `payment_destination_code`: `DANA`, `OVO`, `GOPAY`, or `SHOPEEPAY`; OVO needs at least 10,000 IDR. Bank transfer `payment_destination_code`: the 3-digit `code` or `swift_code` from `listBanks?country_code=ID` (the account must have IDR enabled). That list is informational; any 3-digit bank code or SWIFT is accepted
Brazil (BR)	`payment_key`	PIX key: phone (+55 format), email, CPF/CNPJ, or random key
Peru (PE)	`ewallet`	Phone number	`payment_destination_code`: `YAPE` or `PLIN`
Bolivia (BO)	`bank_transfer`	Bank account number	Requires `account_type` (`SAVINGS` or `CHECKING`), bank code, and recipient name
Colombia (CO)	`payment_key`	Bre-B key
Nigeria (NG)	`bank_transfer`	Account or mobile wallet number	Institution code from `listBanks`
Ghana (GH)	`bank_transfer`	Account or mobile wallet number	Institution code from `listBanks`
Zambia (ZM)	`bank_transfer`	Bank account number	Bank code from `listBanks`; banks only
Kenya (KE)	`payment_key`	Till or paybill number	Optional `payment_destination_code`: `TILL` or `PAYBILL`. Paybills need `account_reference`, the account, bill or customer number the paybill expects; it is returned in `missing_fields` when absent and the payout is refused without it
Tanzania (TZ)	`payment_key`	Till or paybill number	Optional `payment_destination_code`: `TILL` or `PAYBILL`
Uganda (UG)	`payment_key`	Till or paybill number	Optional `payment_destination_code`: `TILL` or `PAYBILL`

Destinations are validated at lookupPaymentCode time; an invalid or unknown destination fails there, before any quotation or payout.