Transfers

Transfers are two-legged. Bumxpress first collects from the payer, then disburses to the recipient.

Flow

Create a transfer quote

Use POST /quotes/transfer with the source and destination operators, amount, and currencies.

Create the transfer

Submit payer and recipient details with the active transfer quote.

Track both legs

Read transfer status from webhooks or GET /transfers/{transfer_id}.

Field	Required	Description
`payer_operator_code`	Yes	Source-side operator for collection.
`recipient_operator_code`	Yes	Destination-side operator for disbursement.
`payin_amount`	Yes, unless quoting fixed payout	Amount collected from payer.
`payin_currency`	Yes	Source-side currency.
`payout_currency`	Yes	Destination-side currency.
`payout_amount`	No	Optional fixed payout amount.

Your merchant account must have an active transfer corridor configured before transfer quotes succeed.

Last modified on July 8, 2026