KYC Verification
โ
Rapid Verification Methods
Rapid supports four flexible verification options to help you meet compliance requirements and onboard users globally:
- Built-In Verification (US & Non-US)
- KYC Reliance
- Passing External KYC Data
- Sumsub Token Sharing
๐ Rapid's Built-In Verification
๐บ๐ธ Verifying US Withdrawers
Use the Register User endpoint with KycUsRequestBody:
-
Inputs: Email, name, address, country, date of birth, last 4 digits of SSN
-
If verification passes instantly โ โ you're done.
-
If verification fails:
- API returns
451with averificationLink - Withdrawer's status is set to pending
- Redirect the user to the
verificationLinkto complete selfie + full SSN submission - Theyโll be sent back to your
redirectLinkafter completing verification
- API returns
๐ Verifying Non-US Withdrawers
Use the same Register User endpoint with KycDocVRequestBody:
- Inputs: Email and country (minimum)
- Always returns a
451requiring further verification - User is sent to the
verificationLinkto upload a photo ID and take a selfie - After success, Rapid redirects them to your
redirectLink
Using Rapid's prebuilt UI? You donโt need to handle these verification redirects โ Rapid manages them for you.
๐ค KYC Reliance
For merchants with their own KYC provider (not Sumsub) who want to share verified user data with Rapid.
Steps to Enable:
-
Request Rapid's KYC Reliance Questionnaire
-
Submit for Compliance Review
-
Enable Sandbox Testing
- Rapid enables the KYC attestation feature in your sandbox
-
Integrate Attested Endpoint
- After approval, call the KYC attested endpoint in production
If not approved, fallback to Passing External KYC Data
๐ค Passing External KYC Data
Allows you to pass verified user information to Rapid from your own KYC provider (non-Sumsub).
Requirements:
- Call the
Register User via Documentendpoint - Required fields:
email,country,frontandbackof photo ID
Behavior:
-
Approvely attempts to reverify submitted data
-
If re-verification fails:
- Returns
451 - User uploads ID + selfie via
verificationLink - On success, theyโre redirected to your
redirectLink
- Returns
If using Rapid's prebuilt UI, call this endpoint before rendering so a verification record exists.
๐ Sumsub Token Sharing with Rapid
For merchants with their own Sumsub account
Allows you to reuse KYC data already collected through Sumsub by setting up a tri-party agreement.
How to Get Started:
-
Contact Approvely with your Sumsub client ID
-
Get tri-party data-sharing agreement signed via Sumsub
-
After approval:
- Call Sumsubโs
Generate Share Token - Call Rapid's
Register User Via Share Token - Use Rapid's prebuilt UI (e.g.
CoinflowWithdraw) after registration
- Call Sumsubโs
Rapid will provide its Sumsub client ID upon request.
๐ Verification Method Comparison
| Verification Method | Who It's For | Setup Required | Fallback (451) Handling |
|---|---|---|---|
| Built-In Verification | All merchants | Call Register User | Handled via verificationLink |
| KYC Reliance | Merchants with approved KYC providers (non-Sumsub) | Submit compliance docs + call attestation | Not expected |
| Pass External KYC Data | Merchants with their own KYC provider (non-Sumsub) | Call Register User via Document | User re-verifies with selfie + ID |
| Sumsub Token Sharing | Merchants using Sumsub | Sign tri-party agreement + share token | Not expected |
Updated 7 months ago