Login

Update Static Account

Allows merchants to correct the BVN of static virtual account

POST https://developer.tingg.africa/checkout/v2/custom/requests/update-virtual-account

Header Parameters

HeaderValueRequired
AuthorizationBearer <Bearer_Token> generated during authenticate request in step 1.YES
Content-Typeapplication/jsonYES

Request Parameters

Parameter NameTypeDescriptionRequired
merchantRefstringThis is a uniqueID on merchant’s end for every request to generate a static account.TRUE
accountNamestringThis is the name the customer will see when paying into the virtual account.TRUE
serviceCodestringThe customer’s unique code to identify the merchant on checkout.TRUE
virtualAccountstringVirtual account that you can use to pay into for all your payment requests.TRUE
bvnstringThis is the bank verification number issued to the customer or merchantTRUE

Example

{
    "merchantRef": "8398424REGRT422",
    "accountName": "<ACCOUNT_NAME>",
    "serviceCode": "<SERVICE_CODE>",
    "virtualAccount": "<VIRTUAL_ACCOUNT>",,
    "bvn": "WEMA"
}

Response Parameters

Parameter NameTypeDescription
statusCodestringRequest status code. See full status code details below
statusDescriptionstringDescription of the transaction status

Example

Successful Response

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

Failure Response

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

Authentication Failure Response

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