Skip to main content
POST
Debits a member’s currency wallet (the member is identified by id in the path). The request is created as Pending and the tokens are moved into escrow; it still needs to be approved before funds are disbursed. The balance and escrow are the member’s, and owner_model is user (versus organisation for the organisation withdrawal). The withdrawal.created webhook still fires to your organisation.

Fees

The fee is taken out of the amount, not added on top — so the member receives less than they asked for, and your interface should say so before they confirm. disburse_amount = amount − fee Treat the fee and disburse_amount fields on the response as authoritative rather than hard-coding the figure — fees change without an API version bump. A withdrawal for less than the fee is rejected with Insufficient amount for fees.
string
required
The member’s user ID.
number
required
The amount to withdraw. Must be ≥ 1, ≤ the member’s currency wallet balance, and ≥ MINIMUM_WITHDRAWAL_<CUR>.
string
required
Matched against Flutterwave’s bank list to resolve the code — pass the full name (e.g. Guaranty Trust Bank, not GTBank).
string
required
The account holder’s name. For NGN it is replaced with Flutterwave’s resolved name when available.
string
required
The destination account number.
string
required
The withdrawal currency. One of NGN, KES, GHS, ZAR, UGX, TZS.

Errors