Docs Transfers

Initiate Transfers

Our Transfers API allows you to send money from your HwebPay wallet to any bank account in Nigeria. This is an "Admin-Only" operation requiring explicit signature verification.

IP Whitelisting

Payouts are only allowed from IP addresses whitelisted in your Dashboard Settings.

HMAC Signature

Every transfer request MUST be signed. Unsigned requests will be automatically rejected (401).

Transfer Endpoint

POST /transfers

Request Signing (Security)

Calculate an HMAC-SHA512 hash of your JSON request body using your **Secret Key** as the hashing secret.

Header Definition

X-HwebPay-Signature: d98234ab8e8234... (HMAC-SHA512 Hex)

Request Body

Field	Required	Description
amount	YES	Amount in NAIRA (Decimal supported, e.g. 5000.50).
bank_code	YES	Standard 3 or 6 digit CBN bank code.
account_number	YES	The 10-digit NUBAN account number.
reference	-	Highly Recommended. Used for idempotency check.

T+0 Speed

Transfers are processed instantly. Once our system receives a success from the clearing switch, we debit your wallet and trigger a payout.processed webhook.

Sandbox

Banks & Accounts

Developer Community