Skip to content
LogoLogo

Integration Flows

End-to-end sequence diagrams for Wallet, Onramp (Checkout), and Payout. Jump to a product:

Prerequisites

  • Contact the BLOX team to enable API key access for sandbox and production
  • Register a signer public key when your API key is created
  • Use sandbox until your flow is verified

Auth: blox-api-key on every request; RFC 9421 signature on POST/PUT/PATCH/DELETE. See Authentication · Environments.

Wallet: transfer MYRC

Move MYRC from your BLOX wallet to an external address.

Loading diagram...

Steps

  1. Resolve tokenId from GET /v1/wallet/networks.
  2. Call POST /v1/wallet/token/withdrawals with tokenId, addressTo, amount (sen), optional reference. See Create Token Transfer.
  3. Monitor with GET /v1/wallet/token/withdrawals/{id}; use the transaction list later for reconciliation.

Amount range: 1,000–100,000,000 sen (RM 10 – RM 1,000,000).

Wallet: fiat withdrawal

Withdraw MYR from your BLOX wallet to a linked bank account.

Loading diagram...

Steps

  1. List bank accounts with GET /v1/wallet/bank-accounts.
  2. Call POST /v1/wallet/fiat/withdrawals with bankAccountId, amount, optional reference. See Create Fiat Withdrawal.
  3. Monitor with GET /v1/wallet/fiat/withdrawals/{id}; use the transaction list later for reconciliation.

Amount range: 1,000–100,000,000 sen (RM 10 – RM 1,000,000).

Onramp (Checkout)

Collect MYR via a BLOX checkout link and deliver MYRC to a destination address.

Loading diagram...

Steps

  1. Create checkout — POST /v1/checkout with type, addressTo, amount (sen, RM10–RM1M), tokenId, redirectUrl, title, optional description. See Create checkout. type is required: BLOX_ACCOUNT (no fee), FPX_HOSTED (add feeMode; the buyer picks their bank on the BLOX page), or FPX_DIRECT (add feeMode, buyerName, bank, bankType).
  2. Send the customer to checkoutUrl from the response.
  3. Track status — poll GET /v1/checkout/:id and/or handle the per-request checkout webhook.

Amount range: 1,000–100,000,000 sen (RM 10 – RM 1,000,000).

Payout API

Send bank payouts from a prefunded balance, on the same /v1 surface as Wallet and Onramp.

Loading diagram...

Steps

  1. Confirm prefund with GET /v1/payout/prefund/balance.
  2. Create a payout with POST /v1/payouts (amount RM1–RM100k, feeMode, an Idempotency-Key header, exactly one of beneficiaryId or inline beneficiary). See Create Payout.
  3. Handle payout webhooks and/or poll GET /v1/payouts/:id.

Amount range: 100–10,000,000 sen (RM 1 – RM 100,000).

Next steps