Create Boldd AccountLogin

Create Customer - (Full KYC)

This endpoint is used to create an account for a customer issuing a card. A customer tracking ID is returned which can be used access other resource such as virtual card, USD, GBP, EUR accounts etc.

POST {{base_url}}/business/fullkyc-customer

Headers

Name
Type
Description

Authorization*

String

SECRET_KEY

Request Body

Name
Type
Description

first_name*

Sting

Customer first name e.g John

last_name*

String

Customer lastname e.g Doe

email_address*

String

Customer Email e.g [email protected]

phone_number*

String

Customer mobile number e.g +2347012345689

address*

Object

Check sample request below

bvnno*

String

21345678900

identity*

Object

Check sample request below

birth_date*

String

Date of birth in format yyyy-mm-dd. Must be at least 18 years old. e.g 2000-03-23

nationality*

String

The ISO 3166-1 (three-character) country code representing the nationality of the customer. e.g NGR

middle_name

Stringg

e.g Faith

employement_status*

String

Customer current employment status e.g employed, homemaker, retired, self_employed, student, unemployed

taxno

String

29323239D2

gender*

String

Customer gender i.e male or female

Your secret keys are to be kept secret and only stored on your servers. Do not pass your secret key to the front-end language where it can be exploited.

Sample Identity type - PASSPORT, NIN, DRIVER_LICENSE, VOTER_CARD, NATIONAL_IDENTITY

Take a look at how you might do this:

curl --location '{{base_url}}/business/fullkyc-customer' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer SECRET_KEY' \
--data-raw '{
    "first_name": "John",
    "last_name": "Doe",
    "phone_number": "07012345678",
    "bvnno": "20123456780",
    "birth_date": "2000-03-23",
    "nationality": "NGR",
    "middle_name": "Faith",
    "gender": "male",
    "employment_status": "EMPLOYED",
    "email_address": "[email protected]",
    "taxno": "29323239D2",
    "address": {
        "house_no": "5",
        "street": "queen Estate, Alen road",
        "city": "Ikeja",
        "state": "Lagos State",
        "country": "Nigeria",
        "postal_code": "110320"
    },
    "identity": {
        "idtype": "National identity",
        "idno": "24H675B9084",
        "expiry_date": "24H675B9084",
        "idfront_url": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png",
        "idback_url": "https://res.cloudinary.com/site/image/upload/v1714257348/idcard2.png",
        "issuance_country": "Nigeria"
    }

}'

Sample response

{
    "status": true,
    "responsecode": "01",
    "message": "Customer account fully created for John Doe",
    "trackid": "06211211"
}
PreviousCreate Customer(Tier 1)NextVirtual Card

Last updated

Was this helpful?