Skip to main content
POST
Create disbursement (B2B)

Headers

x-api-key
string
required

Client API Key

x-signature
string
required

HMAC-SHA256 request signature, REQUIRED on this endpoint. Format: t=,v1= where v1 = lowercase hex of HMAC-SHA256(".", signing secret). When present, x-timestamp is ignored (the t inside the signature is window-checked instead). Test your implementation with POST /api/v3/debug/signature-check.

x-timestamp
string

Unix timestamp in milliseconds. Ignored when x-signature is present.

Idempotency-Key
string
required

Unique key per client for safe retries (max 64 chars)

Body

application/json

Disbursement create request

account_no
string
amount
string
bank_code
string
client_wallet_id
string
memo
string
transfer_type
string

Optional: "BIFAST" or "RTOL", defaults to "BIFAST"

Response

Idempotent replay of an earlier successful create

account_holder_name
string
account_no
string
amount
number
bank_code
string
bank_name
string
client_id
string
currency
string
failed_reason
string
id
string
idempotency_key
string
memo
string
net_amount
number
platform_fee
number
status
string
wallet_id
string