Generate Static Account
Allows merchants to generate static accounts for their customers to pay into.
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.gWEMA – for Wema Bank, STERLING – for sterling bank and ZENITH – for Zenith bank | FALSE |
requestDescription | string | The transaction's narrative. | FALSE |
bvn | string | Bank verification number that is 10 to 14 digits issued to the customer or merchant in Nigeria | TUE |
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
}
Updated 7 months ago