Generate Static Account

For static accounts the customer can make payments to the same account without going back to the checkout page to complete the payment.

Header Parameters

Header	Value	Required
Authorization	`Bearer <Bearer_Token>` generated during authenticate request in step 1.	YES
Content-Type	`application/json`	YES

Request Parameters

Parameter Name	Type	Description	Required
merchantRef	`string`	This is a uniqueID on merchant’s end for every request to generate a static account.	TRUE
accountName	`string`	This is the name the customer will see when paying into the virtual account.	TRUE
serviceCode	`string`	The customer’s unique code to identify the merchant on checkout.	TRUE
amount	`string`	Amount to be paid to the virtual account however it does not prevent the customer from changing the amounts they pay into the account.	TRUE
paymentType	`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	FALSE
requestDescription	`string`	The transaction's narrative.	FALSE

Example

{
    "merchantRef": "8398424REGRT422",
    "accountName": "<ACCOUNT_NAME>",
    "serviceCode": "<SERVICE_CODE>",
    "amount": 200,
    "paymentType": "WEMA",
    "requestDescription": ""
}

Response Parameters

Parameter Name	Type	Description
statusCode	`string`	Request status code. See full status code details below
statusDescription	`string`	Description of the transaction status
accountNumber	`string`	Static account the customer can pay into

Example

Successful Response

{
  "status":{
    "statusCode": 200,
    "statusDescription": "Request processed successfully"
  },
  "results": {
    "accountNumber":43623992
  }
}

Failure Response

{
    "status": {
        "statusCode": 422,
        "statusDescription": "serviceCode does not exist"
    },
    "results": null
}

Authentication Failure Response

{
    "message": "Unauthenticated.",
    "status_code": 500
}