DocumentationAPI ReferencesSupportBlogAsk AI
API References

Create Subaccount

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

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

🚧

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
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.

string
required

This is the customer's account number.

string
required

This is the sub-account business name.

string

This is the sub-account business email.

string

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

string

Business contact number.

string
required

Primary business contact number.

string

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

string
required

This is the merchants secret key.

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.

string
required

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

string
required

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

Headers
string
required
Defaults to application/json
Responses

Updated about 7 years ago

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