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"
        }
      }
    }
  }
}