Generate Static Account

This function is used by the merchant to be able to generate a static account that their customer can pay into.

Parameters

Headers

Header	Value	Required
Authorization	Bearer <Bearer_Token> Generated during the authenticate request	Yes
Content-Type	application/json	Yes
apikey	app consumer key	Yes

Request

Parameter Name	Type	Description	Required
merchant_reference	string	This is a uniqueID on merchant’s end for every request to generate a static account	Yes
service_code	string	The customer’s unique code to identify the merchant on checkout.	Yes
amount	double	Amount to be paid to the virtual account however it does not prevent the customer from changing the amounts they pay into the account.	Yes
provider	string	This is to indicate which bank to process the payment via e.g WEMA– for wema bank, STERLING – for sterling bank and ZENITH – for Zenith bank	Yes
account_name	string	Account name for the customer on the merchant system.	Yes
msisdn	string		Yes

Request Body

{
  "merchant_reference": "abc123699",
  "service_code": "SHRADDHASTUDIOONLINE",
  "amount": 0,
  "provider": "WEMA",
  "account_name": "HORLAIDAYPAY",
  "msisdn": "254786835764"
}

Response

Parameter Name	Type	Description
status	JSONObject	Contains status code and description
status_code	Integer	The response status code
status_description	string	Exact description of the status
results	JSONObject	This is an array containing details of the results of the request being processed
virtual_account	string	Static account the customer can pay into

Response Body

{
    "status": {
        "status_code": 200,
        "status_description": "SUCCESSFUL"
    },
    "results": {
        "virtual_account": "000000000"
    }
}

Status Codes

Status Code	Description
200	Success. Checkout request successfully logged in the checkout platform.
500	Failure. Generic failure occurred. Could be as a result of a system failure on the checkout platform.
503	Server could not process your request. Try later.