Create Business Customer
Steps to Create a Business Customer:
You can create a business customer and complete KYC in these steps:
- Send a create business customer request
- Trigger KYB for the business customer
- Upload the required documents
Sample Request Payload to create a business customer
curl --request POST \
--url https://api.sandbox.getanchor.co/api/v1/customers \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'x-anchor-key: ' \
--data '
{
"data": {
"type": "BusinessCustomer",
"attributes": {
"address": {
"country": "NG",
"state": "KANO"
},
"basicDetail": {
"industry": "Agriculture-AgriculturalCooperatives",
"registrationType": "Private_Incorporated",
"country": "NG",
"businessName": "Accelerated Echo Limited",
"businessBvn": "12345678901",
"dateOfRegistration": "1999-06-25",
"description": "Accelerated Echo Limited is a digital marketing business that supports consumers directly by proving easy payments to consumer market",
"website": "https://www.example.com"
},
"contact": {
"email": {
"general": "[email protected]",
"support": "[email protected]",
"dispute": "[email protected]"
},
"address": {
"main": {
"country": "NG",
"state": "LAGOS",
"addressLine_2": "1 James street",
"addressLine_1": "1 James street",
"city": "Ikeja",
"postalCode": "100032"
},
"registered": {
"country": "NG",
"state": "LAGOS",
"addressLine_1": "1099 Pepple street, Computer Village",
"addressLine_2": "1099 Pepple street, Computer Village",
"city": "Ikeja",
"postalCode": "100032"
}
},
"phoneNumber": "07012345678"
},
"officers": [
{
"role": "DIRECTOR",
"fullName": {
"firstName": "Josh",
"lastName": "Steve",
"middleName": "JOHN",
"maidenName": "PHILIP"
},
"nationality": "NG",
"address": {
"country": "NG",
"state": "LAGOS",
"addressLine_1": "1 James street",
"addressLine_2": "Onike",
"city": "Yaba",
"postalCode": "100032"
},
"dateOfBirth": "1994-06-25",
"email": "[email protected]",
"phoneNumber": "07012345678",
"bvn": "22222222226",
"title": "CEO",
"percentageOwned": 0
},
{
"role": "OWNER",
"fullName": {
"firstName": "Graham",
"lastName": "Bell",
"middleName": "JOHN",
"maidenName": "PHILIP"
},
"nationality": "NG",
"address": {
"country": "NG",
"state": "KANO",
"addressLine_1": "1 James street",
"addressLine_2": "Onike",
"city": "Yaba",
"postalCode": "100032"
},
"dateOfBirth": "2000-06-25",
"email": "[email protected]",
"phoneNumber": "07012345678",
"bvn": "22222222016",
"title": "COO",
"percentageOwned": 100
}
]
}
}
}
'
{
"data": {
"id": "16968633133013-anc_bus_cst",
"type": "BusinessCustomer",
"attributes": {
"createdAt": "2023-10-09T14:55:13.304874",
"isRoot": false,
"contact": {
"email": {
"general": "[email protected]",
"support": "[email protected]",
"dispute": "[email protected]"
},
"phoneNumber": "07012345678",
"address": {
"main": {
"addressLine_1": "1 James street",
"addressLine_2": "1 James street",
"country": "NG",
"city": "Ikeja",
"postalCode": "100032",
"state": "Lagos"
},
"registered": {
"addressLine_1": "1099 Pepple street, Computer Village",
"addressLine_2": "1099 Pepple street, Computer Village",
"country": "NG",
"city": "Ikeja",
"postalCode": "100032",
"state": "Lagos"
}
}
},
"detail": {
"businessName": "Great Busness",
"businessBvn": "12345678901",
"industry": "Agriculture-AgriculturalCooperatives",
"registrationType": "Private_Incorporated",
"dateOfRegistration": "1999-06-25",
"description": "Greate Business is a digital marketing business that supports consumers directly by proving easy payments to consumer market",
"country": "NG",
"website": "https://www.example.com"
},
"verification": {
"status": "unverified"
},
"officers": [
{
"officerId": "16968633133291-anc_bus_off",
"role": "DIRECTOR",
"fullName": {
"firstName": "Josh",
"lastName": "Steve",
"middleName": "JOHN",
"maidenName": null
},
"dateOfBirth": "1994-06-25",
"email": "[email protected]",
"phoneNumber": "07012345678",
"nationality": "NG",
"address": {
"addressLine_1": "1 James street",
"addressLine_2": "Onike",
"country": "NG",
"city": "Yaba",
"postalCode": "100032",
"state": "Lagos"
},
"bvn": "22222222226",
"percentOwned": 0
},
{
"officerId": "16968633133312-anc_bus_off",
"role": "OWNER",
"fullName": {
"firstName": "Graham",
"lastName": "Bell",
"middleName": "JOHN",
"maidenName": null
},
"dateOfBirth": "2000-06-25",
"email": "[email protected]",
"phoneNumber": "07012345678",
"nationality": "NG",
"address": {
"addressLine_1": "1 James street",
"addressLine_2": "Onike",
"country": "NG",
"city": "Yaba",
"postalCode": "100032",
"state": "Kano"
},
"bvn": "22222222016",
"percentOwned": 100
}
],
"status": "ACTIVE"
},
"relationships": {
"documents": {
"data": []
},
"organization": {
"data": {
"id": "16534918589610-anc_og",
"type": "Organization"
}
}
}
}
}
Updated 4 months ago