Skip to main content
Copy page
View as Markdown

Start a chat pointed at this page

Open in ChatGPTOpen in Claude

Create Onboarding Session

POST 
/onboarding/:CustomerID

This endpoint initiates Noah's Standard Model onboarding flow. Through this solution, Noah establishes direct contractual relationships with your end customers, handling all KYB/KYC verification and Terms and Conditions acceptance on your behalf.

Use the endpoint to retrieve a response consisting of a URL, which you pass to your customer so that they can enter their details in a Hosted Onboarding session.

The returned HostedURL includes a session JWT. Individual hosted onboarding sessions expire 1 hour after creation. Business hosted onboarding sessions expire 24 hours after creation — when the customer already exists, this follows the stored customer type; otherwise it follows CustomerType. Generate the URL on demand rather than storing unused links. After expiry, call this endpoint again to mint a new session.

Follow the step-by-step guide: Hosted Onboarding Recipe

info

Additional KYC applications for users who have already completed KYC will be rejected. Duplicate applications are flagged as a fraud prevention measure. If a user has already completed KYC, do not initiate another KYC session. Instead, retrieve the user's existing verification status. For details, see KYC Platform.

Note: Customers needing to process USD payments must make use of Hosted Onboarding, rather than using Reliance Onboarding.

Request​

Responses​

Hosted onboarding session request successful. The OnboardingStatus field indicates an action is required to complete the onboarding.