Create Split Account
This creates a new split settlement account for the authenticated merchant. It can be referenced during Checkout transactions.
Note:
- A unique split account code is generated when a split account is successfully created.
- This code is required when configuring split settlements in the Checkout SDK.
Authorizations
Payaza {{Public API Key in Base 64}}
live or test
Body
The beneficiary bank account number.
"0123456789"
The name of the beneficiary bank account.
"John Doe"
The bank code of the beneficiary bank.
"000001"
The name assigned to the Split Account.
"John doe"
The beneficiary email address.
"johndoe@gmail.com"
The settlement currency (ISO 4217).
"NGN"
The country code (ISO 3166-1 Alpha-3).
"NGA"
The calculation mechanism applied to process transaction splits (e.g., PERCENTAGE, FLAT). PERCENTAGE allocates funds on a percentage of the transaction amount while FLAT allocates a fixed amount from the transaction
"PERCENTAGE"
Percentage or flat amount allocated to the Payaza Account owner.
2
Response
Create Split Account Response
System operational status response code tracking the request transaction performance.
"00"
Indicates if the request completed successfully.
true
Details regarding operational processing failure conditions. Returns null on success context.
null
The payload containing tracking identifiers generated for the new split account configuration.
Descriptive message confirming the configuration outcome.
"split account created successfully"