Create Subaccount

post

https://api.ravepay.co/v2/gpx/subaccounts/create

This page shows you how to create a subaccount on rave.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

🚧
Using percentages as split type
When setting up your split_type value as a percentage, you would need to add the percentage value i.e. split_value in decimal. e.g. split_value: 0.09 is equal to a 9% commission on transactions.

Body Params

account_bank

string

required

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

account_number

string

required

This is the customer's account number.

business_name

string

required

This is the sub-account business name.

business_email

string

This is the sub-account business email.

business_contact

string

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

business_contact_mobile

string

Business contact number.

business_mobile

string

required

Primary business contact number.

meta

string

This allows you pass extra/custom information about the sub-account. it can be passed this way: "meta": [{"metaname": "MarketplaceID", "metavalue": "ggs-920900"}]

seckey

string

required

This is the merchants secret key.

split_type

string

required

This can be set as percentage or flat when set as percentage it means you want to take a percentage fee on all transactions, and vice versa for flat this means you want to take a flat fee on every transaction.

split_value

string

required

This can be a percentage value or flat value depending on what was set on split_type.

country

string

required

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

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Using percentages as split type

200200

400400