US onboarding


This page contains details about the United States Know Your Customer (KYC) flows and links to the following sub-pages for quick reference:

Page nameDescription
US required parametersThis page lists the required API fields for onboarding an individual customer.
US required documentsThis page contains tables listing the required documents for verification of an individual customer.
US request examplesThis page contains API request examples for onboarding an individual customer in the US regulatory region.


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:

  1. Your new customer signs up for verification.
  2. Send a GET request to the Terms and Conditions API.
  3. Nium returns the Terms and Conditions description.
  4. Display the Terms and Conditions to your customer to agree and accept. You collect all customer information for onboarding.
  5. Send a POST request to the Unified Add Customer API and upload using eKYC.
  6. Send a POST request to the Accept Terms and Conditions API and include the customerHashId.
  7. Nium returns a success confirmation upon receipt.
  8. Nium directs your customer to your home page.
  9. Nium sends a callback request for any change in the compliance status with the customerHashId.
  10. Send a response with the HTTPS status code 200.
  11. Call the Customer Details V2 API to get the detail information, including the compliance status (complianceStatus) of the customer.
  12. Nium returns the customerDetails object, the complianceStatus field, and the kycStatus field.