Individual Customer KYC

What are the minimum information to provide for KYC to be approved?

Tier/LevelDescription
Tier 0:By default, every customer starts at this level. The required information is the individual customer full name, address, email, and phone number.
Tier 1:You can upgrade a customer to tier 1 by passing BVN, dateOfBirth and gender information of the individual customer. Please note that to validate tier 1, the name and phone number provided when registering the customer (tier 0 ) must match the details in the bvn.
Tier 2:Validation of Individual customers in this tier 2 require manual review of the documents provided. Acceptable documents in this tier include Drivers License,  Voters Card, Int'l Passport, NIN slip, National ID

Tier 0 Customer

Initially, every customer start at Tier 0 as the default level. When a new customer is added, their KYC tier is automatically assigned to 0. The minimum requirement to create a customer at this tier includes the customer’s full name, Full/complete address, email address, and phone number.

Upgrade Customer to Tier 1

You can upgrade a customer initially created in tier 0 to tier 1 by passing the bvn, dateOfBirth and gender information of the customer in the endpoint /customers/{customerId}/verification/individual.

📘

The name and phone number on the bvn needs to match the name and phone number provided at customer creation.

If you provided Identification information at the point of creating the customer, call the verification endpoint to validate the KYC information of the customer you created.

Tier 1 KYC validation is automatic. Under normal circumstances, you should receive the validation result via webhook event immediately, unless there are errors.

VerbURL
POST{{baseUrl}}/api/v1/customers/customers/{customerId}/verification/individual
curl --request POST \
     --url https://api.sandbox.getanchor.co/api/v1/customers/169633499900424-anc_ind_cst/verification/individual \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-anchor-key: <API Key>' \
     --data '
{
  "data": {
    "type": "Verification",
    "attributes": {
      "level": "TIER_2",
      "level2": {
        "bvn": "22222222200",
        "dateOfBirth": "1996-03-20",
        "gender": "Female"
      }
    }
  }
}
'
{}

Individual Customer KYC Events

When you trigger KYC validation for an individual customer, any of the following events may be received.

Event NameDescription
customer.identification.approvedThis event is sent when the KYC is successfully validated.
customer.identification.errorThis event is sent when there is an error or timeout validating the information provided. Retry the KYC validation at a later time.
customer.identification.rejectedThis event is sent when the customer's KYC is rejected. To resolve this, update the customer information and re-trigger the KYC endpoint.