Skip to main content
POST
Debits the calling organisation’s own currency wallet. The request is created as Pending and the tokens are moved into escrow; it still needs to be approved before funds are disbursed. A withdrawal.created webhook is emitted.

Fees

The fee is taken out of the amount you request, not added on top. You ask to withdraw ₦5,000, the fee is ₦500, and ₦4,500 reaches the bank account. disburse_amount = amount − fee Each supported currency has its own flat fee. Fees change without an API version bump, so treat the fee field on the response as authoritative for a given withdrawal rather than hard-coding a figure — and if you show the user a net amount before they confirm, derive it from disburse_amount on the response rather than computing it yourself.
Because the fee comes out of the amount, a withdrawal for less than the fee is rejected rather than disbursing nothing — see Insufficient amount for fees below. A request for exactly the fee is also rejected: disburse_amount would be zero.
number
required
The amount to withdraw. Must be ≥ 1, ≤ your 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