{
"amount": 1000000,
"currency": "NGN",
"redirectUrl": "https://google.com",
"paymentMethod": "bank_transfer"
}
{
"status": "success",
"message": "Payment initiated successfully. Complete payment to fund your wallet.",
"data": {
"paymentMethod": "bank_transfer",
"reference": "GETXN_FI_WX6FLTAVVNVGWG_PMCKDU_1",
"email": "wilpat45677@yopmail.com",
"virtualAccount": {
"bankName": "Mock Bank",
"accountNumber": "0067100155",
"amount": "1002000.00",
"note": "Mock note",
"expiresAt": "2026-07-04 12:32:36 PM"
},
"amountToPay": 1002000,
"amount": 1000000,
"currency": "NGN",
"fees": {
"flutterwave": 2000,
"total": 2000
},
"totalCharge": 1002000
}
}
Wallet
Fund wallet
Initiate a payment to fund your wallet
POST
api
/
wallet
/
fund
{
"amount": 1000000,
"currency": "NGN",
"redirectUrl": "https://google.com",
"paymentMethod": "bank_transfer"
}
{
"status": "success",
"message": "Payment initiated successfully. Complete payment to fund your wallet.",
"data": {
"paymentMethod": "bank_transfer",
"reference": "GETXN_FI_WX6FLTAVVNVGWG_PMCKDU_1",
"email": "wilpat45677@yopmail.com",
"virtualAccount": {
"bankName": "Mock Bank",
"accountNumber": "0067100155",
"amount": "1002000.00",
"note": "Mock note",
"expiresAt": "2026-07-04 12:32:36 PM"
},
"amountToPay": 1002000,
"amount": 1000000,
"currency": "NGN",
"fees": {
"flutterwave": 2000,
"total": 2000
},
"totalCharge": 1002000
}
}
Initiates a payment to fund your wallet. The wallet is credited with
That
amount, while the payer is charged totalCharge (amount plus the processor fee).
When paymentMethod is bank_transfer and currency is NGN, the response returns a virtual account to transfer to. For every other payment method, the response returns a Flutterwave payment link to complete the payment.
{
"amount": 1000000,
"currency": "NGN",
"redirectUrl": "https://google.com",
"paymentMethod": "bank_transfer"
}
{
"status": "success",
"message": "Payment initiated successfully. Complete payment to fund your wallet.",
"data": {
"paymentMethod": "bank_transfer",
"reference": "GETXN_FI_WX6FLTAVVNVGWG_PMCKDU_1",
"email": "wilpat45677@yopmail.com",
"virtualAccount": {
"bankName": "Mock Bank",
"accountNumber": "0067100155",
"amount": "1002000.00",
"note": "Mock note",
"expiresAt": "2026-07-04 12:32:36 PM"
},
"amountToPay": 1002000,
"amount": 1000000,
"currency": "NGN",
"fees": {
"flutterwave": 2000,
"total": 2000
},
"totalCharge": 1002000
}
}
After the payment
The payer comes back to yourredirectUrl with the outcome appended as query parameters:
?status=successful&tx_ref=GETXN_FI_WX6FLTAVVNVGWG&transaction_id=10459445
?status=cancelled&tx_ref=GETXN_FI_KGBW0Y3O2W2GNN
status travels through the browser, so treat it as a hint. Take the tx_ref and call
GET api/transactions/{reference} for the
real outcome, and to know whether the wallet has been credited yet.Was this page helpful?
