Callback to redirect a customer to their application


You can redirect a customer to their application using the callback URL method. To do so, a client needs to invoke the Nium API operation in an asynchronous way. The format described below shows how you can redirect the customer after you successfully complete the Electronic Know Your Customer (eKYC) process. Refer to the customer onboarding page for details specific to the supported region.

You need to redirect the customer to the application where they keep the value fetched during the eKYC. Then, you use the eKYC value to call Nium's Customer Update API to update the rest of the fields required for the onboarding flow.

After receiving the compliance callback nudge, when applicable, a client fetches the customer data by calling the Customer Details V2 API using the customerHashId field to check the status.

Alternatively, the client can opt for the manual KYC process.

POST https://<customerHost:Port>/callback/compliance?customerHashId={customerHashId}


This API only supports the Hypertext Transfer Protocol Secure (HTTPS) protocol. You need to add Nium's IPs to your allow list so Nium's Classless Inter-Domain Routing (CIDR) super netting method to assign IP addresses can make the calls.

Request example

curl -X POST \
  'https://<customerHost:Port>/callback/compliance?customerHashId={customerHashId}' \
 	-H 'content-type: application/json' \
  -H 'x-request-id: 123e4567-e89b-12d3-a456-426655440000' \
  -H 'x-client-name: client1' \

Query parameters

customerHashIdThis field accepts the unique customer identifier generated upon customer creation.Required