DocumentationAPI ReferencesSupportBlogAsk AI
API References

Create a collection subaccount

post
https://api.flutterwave.com/v3/subaccounts

This document shows you how to create a subaccount on Flutterwave

Body Params
string
required
Defaults to 044

This is the sub-accounts bank ISO code, use the List of Banks for Transfer endpoint to retrieve a list of bank codes.

string
required
Defaults to 0690000037

This is the customer's account number. When testing on staging, you can find a list of all available test bank accounts here

string
required
Defaults to Eternal Blue

This is the sub-account business name.

string
required
Defaults to NG

This is the ISO country code of the merchant e.g. NG, GH, KE etc.

double
required
Defaults to 0.5

This can be a percentage value or flat value depending on what was set on split_type.Note that the % value is in decimal. So 50% is 0.5 and so on.

string
required
Defaults to 090890382

Primary business contact number

string
Defaults to [email protected]

This is the sub-account business email

string
Defaults to Richard Hendrix

This is the contact person for the sub-account e.g. Richard Hendrix

string
Defaults to 090890382

Business contact number number

string
Defaults to percentage

This can be set as percentage or flat

meta
array of objects

This is an array that allows you pass more information about the sub-account. Click the Add button below to see sample properties

meta
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