🔒Account BVN Update

The Central Bank of Nigeria, released a circular recently, regarding virtual accounts issued to customers, as follows: Every virtual account must be linked with either a Bank Verification Number (BVN)

POST https://api.payvessel.com/pms/api/external/request/virtual-account/{businessid}/{account}/

Path Parameters

Name	Type	Description
businessid*	string
account*	number

Request Body

Name	Type	Description
bvn*	string

200: OK

{
    "status": true,
    "service": "VIRTUAL_ACCOUNT_UPDATE",
    "bvn": "23454345457",
    "business": "45EFBDB3FD0348B981BE",
    "banks": {
        "bankCode": "120001",
        "bankName": "9Payment Service Bank",
        "accountNumber": "5004425197",
        "accountName": "ADE OLA",
        "account_type": "STATIC",
        "expire_date": null,
        "trackingReference": "D5CF1038YKXAOE"
    }
}

400: Bad Request

{
    "message": "invalid bvn",
    "status": false,
    "code": "05"
}

Request Headers

headers = {
  'api-key': 'PVKEY-F2LGZEGRRRYRYHK4AA7N5JP',
  'api-secret': 'Bearer PVSECRET-5GRHRTETHREJHEYQ0Q2Y',
  'Content-Type': 'application/json'
}

Request Body

{
    "bvn": "23454345457"
    
}

Response Body

{
    "status": true,
    "service": "VIRTUAL_ACCOUNT_UPDATE",
    "bvn": "23454345457",
    "business": "45EFBDB3FD0348B981BE",
    "banks": {
        "bankCode": "120001",
        "bankName": "9Payment Service Bank",
        "accountNumber": "5004425197",
        "accountName": "ADE OLA",
        "account_type": "STATIC",
        "expire_date": null,
        "trackingReference": "D5CF1038YKXAOE"
    }
}