โCreate New Customer
A customer is the foundation of almost all Gathr API calls. You will need to create a customer before performing any of the consumer verifications and validations.
Create New Customer
POST
{{baseUrl}}/customers
POST
{{baseUrl}}/customers
Create a new customer on your Gathr tenant to perform verifications and validations against the customers consumer profile.
You cannot create multiple Customers with the same ID Number on the same Gathr Tenant.
Path Parameters
Name | Type | Description |
---|---|---|
tenantId* | String | This is the |
environmentUrl* | String | Environment URL's uat - https://uat.apply.fincheck.co.za prod - https://apply.fincheck.co.za. *Please note that you need to be set up in each environment by a member of the Finch Technologies team, who will share your bearer token with you for the specific environment in a protected link. |
Request Body
Name | Type | Description |
---|---|---|
id_type* | String | This is the type of identification number you want to create the customer with. The options are:
You need to use |
id_number* | String | This is the 13-digit South African ID Number of the Customer you are creating. Each Customer created with When id_type "passport" is selected, there is no validation on the Passport Number. |
first_name* | String | The Customer's First Name as per their ID Document. |
last_name* | String | The Customer's Last Name/Surname as per their ID Document. |
email* | String | The Customer's Email Address. It has to be of the format |
client_reference* | String | This is a reference that you may use to identify and do a lookup on the Customer in your system. Each Customer needs to have a unique |
middle_name | String | The customer's Middle Name as per their ID Document. |
country | String | The Customer's nationality. |
popi* | Boolean | This is used to store whether the Customer has given you Consent under the Protection Of Personal Information (POPI) Act to continue with collecting their data and performing additional verifications in Gathr. |
terms_and_conditions | Boolean | This is used to store whether the Customer has agreed to the Terms and Conditions of the Application and Verifications you are performing. |
Status Codes
Examples
Example Request Body with a valid RSA ID Number
Example Request Body with a Passport Number
Last updated