This function is used by the merchant to be able to update a static virtual account to correct the bank verification number (BVN) assigned to it.
| Header | Value | Required |
|---|
| Authorization | Bearer <Bearer_Token> Generated during the authenticate request | Yes |
| Content-Type | application/json | Yes |
| apikey | app consumer key | Yes |
| Parameter Name | Type | Description | Required |
|---|
| merchant_reference | string | This is a uniqueID on merchant’s end for every request to generate a static account | No |
| service_code | string | The customer’s unique code to identify the merchant on checkout. | Yes |
| virtual_account | string | This is the static account a merchant generated on behalf of the customers. | Yes |
| bvn | string | The bank of Nigeria verification number issued to the merchant or customer. | Yes |
{
"merchant_reference" : "1234556S",
"virtual_account": "833123495",
"service_code": "JOHNDOEONLINE",
"bvn": "1636867868"
}
| 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 |
{
"status" : {
"status_code" : 1,
"status_description" : "SUCCESSFULLY_UPDATED"
},
"results" : null
}
| Status Code | Description |
|---|
| 1 | Success. Checkout request successfully logged in the checkout platform. |
| 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. |
