get
https://api.sandbox.1money.com/v1/customers/hosted/
Retrieve a hosted onboarding customer's current information and KYB verification status.
This is the primary endpoint for polling KYB progress after the end user has been redirected to the hosted onboarding page. You can call this endpoint to check the customer's KYB status when you receive a webhook notification.
Status Values
| Status | Description | Action Required |
|---|---|---|
INIT | Customer created, onboarding not started or in progress | Wait for user to complete the hosted form |
PENDING_REVIEW | KYB submitted by the user, queued for compliance review | No action required |
UNDER_REVIEW | Compliance team is actively reviewing the application | No action required |
PENDING_RESPONSE | Additional information or corrections needed from the user | Create a new onboarding grant to let the user return and update their application |
REJECTED | KYB application rejected | Contact 1money support for details |
APPROVED | KYB verification complete, customer is fully onboarded | Customer is ready for transactions |
Re-entry for PENDING_RESPONSE
When the status is PENDING_RESPONSE, the compliance team has flagged items that need correction. To allow the user to fix them:
- Call
POST /v1/customers/onboarding/grantswith the samecustomer_id - Redirect the user to the new
onboarding_url - The user's previous progress is preserved; they only need to update the flagged items