DocumentationAPI ReferencesSupportBlogAsk AI
API References

Bank Transfers

post
https://api.flutterwave.com/v3/charges?type=bank_transfer

Generate dynamic virtual accounts for instant payments via bank transfers. We recommend you read the method overview before you proceed.

Body Params
int32
required
Defaults to 100

This is the amount to be charged.

string
required
Defaults to [email protected]

This is the email address of the customer

string
enum
required
Defaults to NGN

This is the specified currency to charge in.

Allowed:
string
required
Defaults to MC-MC-1585230ew9v5050e8

This is a unique reference, unique to the particular transaction being carried out.

string
required
Defaults to Yemi Desola

This is the customers full name. It should include first and last name of the customer. This is required for charging in KES and EGP.

string
required
Defaults to 1234567891

This is the customer's account number required for charging in KES and EGP.

string
Defaults to 07033002245

This is the phone number linked to the customer's mobile money account

string
Defaults to 154.123.220.1

IP - Internet Protocol. This represents the current IP address of the customer carrying out the transaction

string
Defaults to 62wd23423rq324323qew1

This is the fingerprint for the device being used. It can be generated using a library on whatever platform is being used

meta
object

This is used to include additional payment information

subaccounts
array of objects

This is an array of objects containing the subaccount IDs to split the payment into.

subaccounts
string

This allows the developer set the name that is shown to the customer when the account is resolved to a name. It also displays in the debit narration.

boolean
Defaults to false

This allows you to create a static account number i.e. the account number doesn't change and customers can pay into the account number multiple times.

string
Headers
string
required
Defaults to Bearer FLWSECK_TEST-SANDBOXDEMOKEY-X

Pass your secret key as a bearer token in the request header to authorize this call

Responses

Updated 9 months ago

Language
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 9 months ago