onboarding session details
POSThttps://api.sandbox.noah.com/v1/customers/hosted-onboarding
Retrieve details for customer onboarding session
Request
Header Parameters
Digitally signed JWT.
- application/json
Bodyrequired
A unique ID which identifies the customer in the Business' internal system and in NOAH.
Possible values: non-empty
and <= 36 characters
550e8400-e29b-41d4-a716-446655440000
The URL to which the user is redirected at the end of the Hosted Checkout session. We will include the CheckoutSessionID, ExternalID and Status of the session, ie ?CheckoutSessionID={CheckoutSessionID}&ExternalID={ExternalID}&Status={Status}
Possible values: >= 10 characters
and <= 1000 characters
Responses
- 200
- 400
- 401
- 500
HostedURL successfully created.
- application/json
- Schema
- Example (auto)
Schema
URL to redirect the customer to the kyc page.
{
"HostedURL": "string"
}
Bad request
- application/json
- Schema
- Example (auto)
Schema
- InvalidMessage
- Unexpected
- ResourceNotFound
- Unauthorized
- Forbidden
- InsufficientBalance
Type of error:
InvalidMessage
A unique reference that identifies the specific occurrence of the problem
Action taking place which resulted in error.
Details about the error.
Extensions object
{
"Type": "InvalidMessage",
"Instance": "string",
"Action": "string",
"Detail": "string",
"Extensions": {
"Request": {},
"Features": {}
}
}
Client is not authorized to perform this action
- application/json
- Schema
- Example (auto)
Schema
- InvalidMessage
- Unexpected
- ResourceNotFound
- Unauthorized
- Forbidden
- InsufficientBalance
Type of error:
InvalidMessage
A unique reference that identifies the specific occurrence of the problem
Action taking place which resulted in error.
Details about the error.
Extensions object
{
"Type": "InvalidMessage",
"Instance": "string",
"Action": "string",
"Detail": "string",
"Extensions": {
"Request": {},
"Features": {}
}
}
Internal server error
- application/json
- Schema
- Example (auto)
Schema
- InvalidMessage
- Unexpected
- ResourceNotFound
- Unauthorized
- Forbidden
- InsufficientBalance
Type of error:
InvalidMessage
A unique reference that identifies the specific occurrence of the problem
Action taking place which resulted in error.
Details about the error.
Extensions object
{
"Type": "InvalidMessage",
"Instance": "string",
"Action": "string",
"Detail": "string",
"Extensions": {
"Request": {},
"Features": {}
}
}
Authorization: X-Api-Key
name: X-Api-Keytype: apiKeydescription: This security scheme requires an API Key to successfully authenticate.in: header
- curl
- go
- nodejs
- python
- ruby
- csharp
- php
- java
- powershell
- CURL
curl -L 'https://api.sandbox.noah.com/v1/customers/hosted-onboarding' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'X-Api-Key: <X-Api-Key>' \
-d '{
"CustomerID": "550e8400-e29b-41d4-a716-446655440000",
"ReturnURL": "string"
}'