US onboarding
Overview
This page contains details about the United States Know Your Customer (KYC) flows and links to the following sub-pages for quick reference:
Page name | Description |
---|---|
US required parameters | This page lists the required API fields for onboarding an individual customer. |
US required documents | This page contains tables listing the required documents for verification of an individual customer. |
US request examples | This page contains API request examples for onboarding an individual customer in the US regulatory region. |
eKYC – US
When using the Unified Add Customer API to add a customer in the United States, customer should undergo E_KYC
verification.

In the US, the add customer eKYC process is as follows:
- Your new customer signs up for verification.
- Send a
GET
request to the Terms and Conditions API. - Nium returns the Terms and Conditions description.
- Display the Terms and Conditions to your customer to agree and accept. You collect all customer information for onboarding.
- Send a
POST
request to the Unified Add Customer API and upload using eKYC. - Send a
POST
request to the Accept Terms and Conditions API and include thecustomerHashId
. - Nium returns a success confirmation upon receipt.
- Nium directs your customer to your home page.
- Nium sends a callback request for any change in the compliance status with the
customerHashId
. - Send a response with the HTTPS status code
200
. - Call the Customer Details V2 API to get the detail information, including the compliance status (
complianceStatus
) of the customer. - Nium returns the
customerDetails
object, thecomplianceStatus
field, and thekycStatus
field.
Updated 6 days ago