Skip to main content
POST
Create an NGN withdrawal
Withdrawals may enter screening before provider settlement.

Authorizations

X-Key-Id
string
header
required

This selects the registered RSA public key. Also send X-Timestamp, X-Idempotency-Id and X-Digital-Signature.

Headers

X-Key-Id
string
required

Also send X-Timestamp, X-Idempotency-Id and X-Digital-Signature. Sign the exact raw request bytes.

Example:

"prod-2026-02"

Path Parameters

storeId
string<uuid>
required

Body

application/json
recipient_id
string<uuid>
required
amount
string
required
Example:

"1000"

currency
string
required
Example:

"NGN"

client_reference
string

Response

Withdrawal accepted

id
string<uuid>
amount
string
currency
string
status
string
Example:

"screening"

fee_amount
string
fee_currency
string
net_amount
string
client_reference
string