Customers

Customers, belonging to clients are End Users of the system. Customers can be businesses, accredited investors or individuals. Customers have 1 or more Accounts and Payors.

Creating a new Customer

There are 2 different ways to create a new customer:

Applications

An Application collects required Know Your Business (KYB) and/or Know Your Customer (KYC) data on the customer. This data is validated, approved by Layer2 and its relevant partners to ensure compliance with regulatory requirements. When creating the application, you have to pass it a customer_id which is your unique reference for the customer in your systems. Once the KYB, KYC information is validated and approved, the customer and a default Account are created in Layer2. Click here to learn more on Applications.

Customers

If you are a regulated Financial Institution, you can skip the Application process and create a Customer using the customers endpoint. When creating the customer, you have to pass it a customer_id which is your unique reference for the customer in your systems. To learn more about how external identifiers work, click here.

NOTE: In sandbox, you have to create a customer via the Applications endpoint. You will have 2 default customers created for you, one corporate and one individual.

Retrieving Customer(s)

To get details on a specific customer, use the customers/{customer_id} endpoint

You can retrieve all the customers using the customers endpoint. You can provide filter criteria in the query parameters such as type and status.

Updating Customer Details

Once the Customer is provisioned, you then have to use the PATCH customers/{customer_id} endpoint