Update Reserved Account KYC Info

This API provides an entry point for merchants to link customers BVN and/or NIN to their respective reserved accounts.

The API accepts either the customer’s BVN or NIN or both, subject to the following merchant requirements:

For accounts that wish to enjoy the maximum transaction limit, both BVN and NIN must be linked to the reserved account.
For accounts with limited transaction amounts, one of NIN or BVN is required.

This endpoint is protected with OAuth 2.0 Bearer token. To find out more about authorization for Monnify endpoints, check Here

Endpoint URL: {{base_url}}/api/v1/bank-transfer/reserved-accounts/{accountReference}/kyc-info

HTTP Method: PUT

Sample Request

curl --location --request PUT 'https://sandbox.monnify.com/api/v1/bank-transfer/reserved-accounts/{accountReference}/kyc-info' \
--data-raw '{
      "bvn":"22222222226",
      "nin":"1047495939309"
}'

Sample Success Response

{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
          {
				"accountReference":"ab3ed-ashdg-s23bdj",
				"accountName": "OMEH CHIZITEREM",
				"customerEmail": "omeh.chiziterem@gmail.com",
				"customerName": "OMEH CHIZITEREM",
				"bvn":"22222222226",
				"nin":"1047495939309"
          }
}

Sample Failed Response

{
    "requestSuccessful": false,
    "responseMessage": "Invalid NIN",
    "responseCode": "99"
}

Field Reference

Field	Description	Status
bvn	The BVN number linked to the customer’s name	Optional when NIN is used
nin	The NIN number linked to the customer’s name	Optional when BVN is used
accountReference	The account reference used to create the reserved account	Required
accountName	The name to be shown during name enquiry	Optional
customerEmail	The customer’s email address	Optional
customerName	The name of the customer. This will be replaced by the name linked to the BVN or NIN	Optional