Reusable KYC (Shared KYC)
For AI agents: visit https://docs.payb.is/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI.
Jump to Content
Status page
GuidesRecipesAPI ReferenceChangelog
v4.1.12Status page
Guides
v4.1.12GuidesRecipesAPI ReferenceChangelog
Reusable KYC (Shared KYC)
About Paybis
Welcome to Paybis
Why Integrate with Usgetting started
Integration Process
Whitelabel SetupRamps
Fiat-to-Crypto On Ramp
Crypto-to-Fiat Off Ramp
Capabilities and Coverage
Supported Assets
Supported Countries
Payment Methods
Payout Methods
Ramps Integration Guides
Choosing the Right Integration Path
Platform Compatibility & Limitations
Web: API-Based Integration
Web: Standalone Integration
Generating HMAC Signatures
Web SDK
Embedded Mode
Standalone Integration Guide
Custom Frontend Integration: Technical Requirements
Internal Events
Helpful Tips
Mobile: iOS SDK
Mobile: Android SDK
Mobile: SDK Integration on Flutter Apps
Ramp SDK for React Native
Use cases
Frictionless Off-Ramping for Wallets
One-click checkout
One-click login and checkout via Apple Pay
Promo codes for buying/selling crypto
Customizing  User Journeys: Remove Any Friction
Supply user email and wallet
Single sign-on (SSO)
Reusable KYC (Shared KYC)
Set default payment method
Control transaction fiat, crypto and amount
Auth key login
Set payment method for Google Pay, Apple Pay, and Credit CardsCorporate ramps
Product Overview
Integration Guide
KYB Onboarding Guide
Supported Assets
Payment and Payout MethodsPaybis Send
Product Overview
Crypto Pay-outs Integration Guide
Fiat Pay-outs Integration Guide
Crypto Pay-ins Integration Guide
Partner Portal Overview
Send Crypto Payouts
Send Fiat Payouts
Transaction Overview
Capabilities and Coverage
Supported AssetsPartner portal
Product Overview
Left-side panel and Dashboard
Profile SettingsHElp and support
Partner support portalRAMP Integration for EMI
EMI Partner API Integration Guide
Powered by
Reusable KYC (Shared KYC)
Paybis allows you to avoid repeated KYC for your verified customers on a per-user basis (with applicant data sharing) for those using Sumsub as a KYC provider.
The recommended approach is to integrate Shared KYC, allowing seamless data sharing between the partner and Paybis via Sumsub.
❗️
Ensure that your Sumsub subscription allows for Sumsub KYC sharing. To verify this, reach out to your Sumsub Manager and confirm whether this option is available.
Understanding Customer Categories and Verification Requirements
To ensure compliance and risk mitigation, Paybis categorizes customers into four groups, each with specific verification needs:
Regular: Requires Basic Verification (personal information, ID document, selfie).
US: Requires Basic Verification plus Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN).
High Risk: Requires Basic Verification.
UK: Paybis will always request KYC, regardless of partner verification.
ℹ️
Please find the document organized by country here: Paybis SumSub configuration to ensure that the relevant information is transmitted.
Required Data for Basic Verification
The following personal information is required:
Applicant data:
Tax Residence Country,
First Name (extracted from the POI),
Last Name (extracted from the POI),
Date of Birth (extracted from the POI),
Nationality (extracted from the POI),
Country,
City,
Street,
Postcode.
ℹ️
Important: Please note that the "Country" and "Tax Residence Country" information should be obtained from the "Provided information" section, not from the "Extracted Information" section.
ended approach is to integrate Shared KYC, allowing seamless data sharing between the partner and Paybis via [Sumsub](https://docs.sumsub.com
The following identity verification information is required:
Government-issued ID document (e.g., passport, residence permit),
Selfie (for liveness check).
ℹ️
If any of the required data is missing, Paybis may:
Request Additional Information: Prompt the user to provide the missing details within the widget.
Initiate Verification: Start a new KYC verification process if the missing information is critical.
Reject the Transaction: In some cases, the transaction may be rejected if essential information is not provided.
🚧
Only users whose applications have been approved on the partner's platform should be shared with Paybis.
Important Notes
Ensure the data collected on your platform matches the information on the user's identification documents.
Use Sumsub's API to securely transmit the collected data to Paybis.
Consult your Paybis account manager for any questions or concerns.
Reference for Verification Setup
Basic verification setup
To configure the basic verification process for your applicants, please follow the steps below:
Identity Document Verification
Supported Document Types: Passport, ID Card, Residence Permit.
Selfie Verification
Selfie Type: Choose Advanced liveness check.
Applicant Data Collection: Tax Residence Country - Required, Country - Required, City - Required, State - Leave as optional (not required), Street - Required, Postcode - Required.
ℹ️
Important
For the following countries the TIN will be requested and validated on the first transaction:
Switzerland (CHE), Austria (AUT), Belgium (BEL), Cyprus (CYP), Denmark (DNK), France (FRA), Germany (DEU), Greece (GRC), Hungary (HUN), Ireland (IRL), Iceland (ISL), Italy (ITA), Liechtenstein (LIE), Luxembourg (LUX), Portugal (PRT), Slovenia (SVN), Spain (ESP).
If you want to skip the validation step at On/Off Ramp, you can request and validate TIN on your side.
For the following countries the TIN will be extracted from the user's identification document: Malta (MLT), Netherlands (NLD), Norway (NOR), Sweden (SWE), Finland (FIN), Lithuania (LTU), Latvia (LVA), Estonia (EST), Croatia (HRV), Slovakia (SVK), Czech Republic (CZE), Bulgaria (BGR), Romania (ROU), Poland (POL).
Questionnaire: Add the Basic questionnaire.
To apply the required financial questionnaire:
Log in to your Sumsub dashboard.
Create a new questionnaire by importing the provided JSON structure.
Assign the Basic questionnaire to the basic verification flow.
JSON
{
"sharedTo": null,
"copyOf": null,
"acknowledged": null,
"id": "paybis_account_due_diligence",
"title": "",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"modifiable": null,
"showTitleAsStepName": null,
"sections": [
{
"id": "purpose_of_account",
"title": "Purpose of Account",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Purpose of Account"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "purpose_of_account_options",
"title": "What is the primary purpose of opening an account with Paybis?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "What is the primary purpose of opening an account with Paybis?"
}
]
},
"desc": "Select all that apply.",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Select all that apply."
}
]
},
"type": "multiSelect",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "purchase_crypto",
"title": "Purchase crypto-assets",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Purchase crypto-assets"
}
]
},
"score": 0
},
{
"value": "sell_crypto",
"title": "Sell crypto-assets",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Sell crypto-assets"
}
]
},
"score": 0
},
{
"value": "exchange_crypto",
"title": "Exchange crypto-assets",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Exchange crypto-assets"
}
]
},
"score": 0
},
{
"value": "long_term_investment",
"title": "Long-term investment",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Long-term investment"
}
]
},
"score": 0
},
{
"value": "personal_savings",
"title": "Personal savings or portfolio diversification",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Personal savings or portfolio diversification"
}
]
},
"score": 0
},
{
"value": "payments_or_transfers",
"title": "Payments or transfers",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Payments or transfers"
}
]
},
"score": 0
},
{
"value": "business_related",
"title": "Business-related transactions",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Business-related transactions"
}
]
},
"score": 0
},
{
"value": "custody_of_crypto",
"title": "Custody of crypto-assets",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Custody of crypto-assets"
}
]
},
"score": 0
},
{
"value": "other",
"title": "Other",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Other"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
},
{
"id": "purpose_of_account_other",
"title": "Please specify other purpose",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Please specify other purpose"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "text",
"required": true,
"format": "min:4",
"condition": "purpose_of_account.purpose_of_account_options=other",
"showCondition": null,
"placeholder": "Type here",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Type here"
}
]
},
"options": null,
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": false,
"randomItemsCount": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": "employment_status",
"title": "Employment Status",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Employment Status"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "employment_status_option",
"title": "What is your current employment status?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "What is your current employment status?"
}
]
},
"desc": "Select one option.",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Select one option."
}
]
},
"type": "select",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "employed_full_time",
"title": "Employed (full-time)",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Employed (full-time)"
}
]
},
"score": 0
},
{
"value": "employed_part_time",
"title": "Employed (part-time)",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Employed (part-time)"
}
]
},
"score": 0
},
{
"value": "self_employed",
"title": "Self-employed",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Self-employed"
}
]
},
"score": 0
},
{
"value": "business_owner",
"title": "Business owner",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Business owner"
}
]
},
"score": 0
},
{
"value": "retired",
"title": "Retired",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Retired"
}
]
},
"score": 0
},
{
"value": "student",
"title": "Student",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Student"
}
]
},
"score": 0
},
{
"value": "unemployed",
"title": "Unemployed",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Unemployed"
}
]
},
"score": 0
},
{
"value": "other",
"title": "Other",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Other"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
},
{
"id": "employment_status_other",
"title": "Please specify your employment status",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Please specify your employment status"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "text",
"required": true,
"format": "min:2",
"condition": "employment_status.employment_status_option=other",
"showCondition": null,
"placeholder": "Type here",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Type here"
}
]
},
"options": null,
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": false,
"randomItemsCount": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": "source_of_funds",
"title": "Source of Funds",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Source of Funds"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "source_of_funds_options",
"title": "What is the source of the funds that you intend to use for transactions through Paybis?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "What is the source of the funds that you intend to use for transactions through Paybis?"
}
]
},
"desc": "Select all that apply.",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Select all that apply."
}
]
},
"type": "multiSelect",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "employment_income",
"title": "Employment income",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Employment income"
}
]
},
"score": 0
},
{
"value": "business_income",
"title": "Business income",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Business income"
}
]
},
"score": 0
},
{
"value": "self_employment_income",
"title": "Self-employment income",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Self-employment income"
}
]
},
"score": 0
},
{
"value": "savings",
"title": "Savings",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Savings"
}
]
},
"score": 0
},
{
"value": "investments",
"title": "Investments",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Investments"
}
]
},
"score": 0
},
{
"value": "crypto_profits",
"title": "Cryptocurrency investments or trading profits",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Cryptocurrency investments or trading profits"
}
]
},
"score": 0
},
{
"value": "dividends",
"title": "Dividends",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Dividends"
}
]
},
"score": 0
},
{
"value": "sale_of_assets",
"title": "Sale of assets or property",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Sale of assets or property"
}
]
},
"score": 0
},
{
"value": "inheritance",
"title": "Inheritance",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Inheritance"
}
]
},
"score": 0
},
{
"value": "gift_or_donation",
"title": "Gift or donation",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Gift or donation"
}
]
},
"score": 0
},
{
"value": "pension_income",
"title": "Pension income",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Pension income"
}
]
},
"score": 0
},
{
"value": "other",
"title": "Other",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Other"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
},
{
"id": "source_of_funds_other",
"title": "Please specify other source of funds",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Please specify other source of funds"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "text",
"required": true,
"format": "min:3",
"condition": "source_of_funds.source_of_funds_options=other",
"showCondition": null,
"placeholder": "Type here",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Type here"
}
]
},
"options": null,
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": false,
"randomItemsCount": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": "expected_volume",
"title": "Expected Monthly Transaction Volume",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Expected Monthly Transaction Volume"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "expected_monthly_volume",
"title": "What is your expected total monthly transaction volume through Paybis?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "What is your expected total monthly transaction volume through Paybis?"
}
]
},
"desc": "Combined value of all transactions.",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Combined value of all transactions."
}
]
},
"type": "selectDropdown",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "Select a range",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Select a range"
}
]
},
"options": [
{
"value": "lt_1000",
"title": "Less than EUR 1,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Less than EUR 1,000"
}
]
},
"score": 0
},
{
"value": "1000_10000",
"title": "EUR 1,000 – EUR 10,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "EUR 1,000 – EUR 10,000"
}
]
},
"score": 0
},
{
"value": "10001_50000",
"title": "EUR 10,001 – EUR 50,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "EUR 10,001 – EUR 50,000"
}
]
},
"score": 0
},
{
"value": "50001_100000",
"title": "EUR 50,001 – EUR 100,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "EUR 50,001 – EUR 100,000"
}
]
},
"score": 0
},
{
"value": "100001_250000",
"title": "EUR 100,001 – EUR 250,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "EUR 100,001 – EUR 250,000"
}
]
},
"score": 0
},
{
"value": "250001_500000",
"title": "EUR 250,001 – EUR 500,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "EUR 250,001 – EUR 500,000"
}
]
},
"score": 0
},
{
"value": "gt_500000",
"title": "More than EUR 500,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "More than EUR 500,000"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": "expected_frequency",
"title": "Expected Transaction Frequency",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Expected Transaction Frequency"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "expected_transaction_frequency",
"title": "How frequently do you expect to use Paybis services?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "How frequently do you expect to use Paybis services?"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "select",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "one_time",
"title": "One-time transaction only",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "One-time transaction only"
}
]
},
"score": 0
},
{
"value": "lt_monthly",
"title": "Less than once per month",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Less than once per month"
}
]
},
"score": 0
},
{
"value": "1_to_5_monthly",
"title": "1–5 transactions per month",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "1–5 transactions per month"
}
]
},
"score": 0
},
{
"value": "6_to_20_monthly",
"title": "6–20 transactions per month",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "6–20 transactions per month"
}
]
},
"score": 0
},
{
"value": "gt_20_monthly",
"title": "More than 20 transactions per month",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "More than 20 transactions per month"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": "pep",
"title": "Politically Exposed Person (PEP) Status",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Politically Exposed Person (PEP) Status"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "pep_status",
"title": "Do you currently hold, or have you held within the last 12 months, a prominent public function, or are you a family member or close associate of such a person?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Do you currently hold, or have you held within the last 12 months, a prominent public function, or are you a family member or close associate of such a person?"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "select",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "no",
"title": "No",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "No"
}
]
},
"score": 0
},
{
"value": "yes",
"title": "Yes",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Yes"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
},
{
"id": "pep_full_name",
"title": "Full name of the Politically Exposed Person (PEP)",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Full name of the Politically Exposed Person (PEP)"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "text",
"required": true,
"format": "min:2",
"condition": "pep.pep_status=yes",
"showCondition": null,
"placeholder": "Full name",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Full name"
}
]
},
"options": null,
"arbitraryDocType": null
},
{
"id": "pep_relationship",
"title": "Relationship to the PEP (if applicable)",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Relationship to the PEP (if applicable)"
}
]
},
"desc": "Leave blank if you are the PEP yourself.",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Leave blank if you are the PEP yourself."
}
]
},
"type": "text",
"required": false,
"format": "min:2",
"condition": "pep.pep_status=yes",
"showCondition": null,
"placeholder": "e.g. spouse, child, business partner",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "e.g. spouse, child, business partner"
}
]
},
"options": null,
"arbitraryDocType": null
},
{
"id": "pep_position",
"title": "Position held",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Position held"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "text",
"required": true,
"format": "min:2",
"condition": "pep.pep_status=yes",
"showCondition": null,
"placeholder": "e.g. Member of Parliament",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "e.g. Member of Parliament"
}
]
},
"options": null,
"arbitraryDocType": null
},
{
"id": "pep_country",
"title": "Country / Jurisdiction",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Country / Jurisdiction"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "countrySelect",
"required": true,
"format": null,
"condition": "pep.pep_status=yes",
"showCondition": null,
"placeholder": "Select country",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Select country"
}
]
},
"options": null,
"arbitraryDocType": null
},
{
"id": "pep_period",
"title": "Period during which the position was held",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Period during which the position was held"
}
]
},
"desc": "Format: YYYY-MM to YYYY-MM (or 'present').",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Format: YYYY-MM to YYYY-MM (or 'present')."
}
]
},
"type": "text",
"required": true,
"format": "min:2",
"condition": "pep.pep_status=yes",
"showCondition": null,
"placeholder": "e.g. 2019-01 to 2024-06",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "e.g. 2019-01 to 2024-06"
}
]
},
"options": null,
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": false,
"randomItemsCount": null
}
]
}
US verification setup
To configure the verification process for US applicants, please follow the detailed instructions below:
Applicant Data Collection
Required Fields: Tax Residence Country, Country, State (Optional), Postcode, City, Street, TIN/SSN (Tax Identification Number/Social Security Number).
Identity Document Verification
Supported Document Types: Passport, ID Card, Residence Permit, Driver License
Country-Specific Configuration: To update or restrict document types, visit ID Document Settings.
Selfie Verification
Selfie Type: Choose Advanced liveness check for selfie verification.
Questionnaire: Add the Occupation Industry (verifyYourInfo) questionnaire.
JSON
{
"id": "verifyYourInfo",
"title": "Occupation Industry",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Occupation Industry"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"modifiable": null,
"sections": [
{
"id": "section1",
"title": "",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": "",
"showCondition": null,
"items": [
{
"id": "whatIsYourOccupation",
"title": "Please choose the industry you work in:",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Please choose the industry you work in:"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "selectDropdown",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "Select an option",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Select an option"
}
]
},
"options": [
{
"value": "Agriculture and Agribusiness",
"title": "Agriculture and Agribusiness",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Agriculture and Agribusiness"
}
]
},
"score": 0
},
{
"value": "Art and Antiques",
"title": "Art and Antiques",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Art and Antiques"
}
]
},
"score": null
},
{
"value": "Automotive",
"title": "Automotive",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Automotive"
}
]
},
"score": null
},
{
"value": "Brokerage",
"title": "Brokerage",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Brokerage"
}
]
},
"score": null
},
{
"value": "Construction and Infrastructure",
"title": "Construction and Infrastructure",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Construction and Infrastructure"
}
]
},
"score": null
},
{
"value": "Consumer Goods",
"title": "Consumer Goods",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Consumer Goods"
}
]
},
"score": null
},
{
"value": "Education",
"title": "Education",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Education"
}
]
},
"score": null
},
{
"value": "Environmental Services",
"title": "Environmental Services",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Environmental Services"
}
]
},
"score": null
},
{
"value": "Finance and Banking",
"title": "Finance and Banking",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Finance and Banking"
}
]
},
"score": null
},
{
"value": "Financial Technology (Fintech)",
"title": "Financial Technology (Fintech)",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Financial Technology (Fintech)"
}
]
},
"score": null
},
{
"value": "Food and Beverage",
"title": "Food and Beverage",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Food and Beverage"
}
]
},
"score": null
},
{
"value": "Gambling or Casino",
"title": "Gambling or Casino",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Gambling or Casino"
}
]
},
"score": null
},
{
"value": "Healthcare",
"title": "Healthcare",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Healthcare"
}
]
},
"score": null
},
{
"value": "Hospitality and Tourism",
"title": "Hospitality and Tourism",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Hospitality and Tourism"
}
]
},
"score": null
},
{
"value": "Insurance",
"title": "Insurance",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Insurance"
}
]
},
"score": null
},
{
"value": "Manufacturing",
"title": "Manufacturing",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Manufacturing"
}
]
},
"score": null
},
{
"value": "Media and Entertainment",
"title": "Media and Entertainment",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Media and Entertainment"
}
]
},
"score": null
},
{
"value": "Personal Care and Beauty",
"title": "Personal Care and Beauty",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Personal Care and Beauty"
}
]
},
"score": null
},
{
"value": "Pharmaceuticals and Biotechnology",
"title": "Pharmaceuticals and Biotechnology",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Pharmaceuticals and Biotechnology"
}
]
},
"score": null
},
{
"value": "Professional Services Providers (Lawyers/Accountants/Notaries Firm)",
"title": "Professional Services Providers (Lawyers/Accountants/Notaries Firm)",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Professional Services Providers (Lawyers/Accountants/Notaries Firm)"
}
]
},
"score": null
},
{
"value": "Recreation and Sports",
"title": "Recreation and Sports",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Recreation and Sports"
}
]
},
"score": null
},
{
"value": "Retail and E-commerce",
"title": "Retail and E-commerce",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Retail and E-commerce"
}
]
},
"score": null
},
{
"value": "Security and Surveillance",
"title": "Security and Surveillance",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Security and Surveillance"
}
]
},
"score": null
},
{
"value": "Technology",
"title": "Technology",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Technology"
}
]
},
"score": null
},
{
"value": "Telecommunications",
"title": "Telecommunications",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Telecommunications"
}
]
},
"score": null
},
{
"value": "Textiles and Apparel",
"title": "Textiles and Apparel",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Textiles and Apparel"
}
]
},
"score": null
},
{
"value": "Third-Party Payment Provider",
"title": "Third-Party Payment Provider",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Third-Party Payment Provider"
}
]
},
"score": null
},
{
"value": "Transportation and Logistics",
"title": "Transportation and Logistics",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Transportation and Logistics"
}
]
},
"score": null
},
{
"value": "Waste Management and Recycling",
"title": "Waste Management and Recycling",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Waste Management and Recycling"
}
]
},
"score": null
},
{
"value": "Virtual Assets Business",
"title": "Virtual Assets Business",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Virtual Assets Business"
}
]
},
"score": null
},
{
"value": "Other",
"title": "Other",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Other"
}
]
},
"score": null
}
],
"arbitraryDocType": null
}
],
"delimiter": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true
}
]
}
High-risk verification setup
❗️
Important
The following countries are classified as high-risk. For users from these countries, please apply the High-Risk Verification Level as outlined below:
Albania (ALB), Algeria (DZA), Angola (AGO), Bahamas (BHS), Bangladesh (BGD), Belize (BLZ), Benin (BEN), Bolivia (BOL), Botswana (BWA), Cabo Verde (CPV), Cambodia (KHM), Cameroon (CMR), the Cayman Islands (CYM), Congo (COG), Côte d’Ivoire (CIV), Dominican Republic (DOM), Ecuador (ECU), Eritrea (ERI), Gambia (GMB), Ghana (GHA), Guatemala (GTM), Guinea (GIN), Haiti (HTI), Honduras (HND), Jamaica (JAM), Jordan (JOR), Kenya (KEN), Kyrgyzstan (KGZ), Laos (LAO), Liberia (LBR), Madagascar (MDG), Mauritania (MRT), Mauritius (MUS), Mongolia (MNG), Morocco (MAR), Namibia (NAM), Nepal (NPL), Niger (NER), Kuwait (KWT), Pakistan (PAK), Panama (PAN), Philippines (PHL), Monaco (MCO), Paraguay (PRY), Rwanda (RWA), Senegal (SEN), Seychelles (SYC), Sierra Leone (SLE), Tajikistan (TJK), Tanzania (TZA), Togo (TGO), Trinidad and Tobago (TTO), Turkmenistan (TKM), Uganda (UGA), Papua New Guinea (PNG), Uzbekistan (UZB), Vanuatu (VUT), Vietnam (VNM), Zambia (ZMB), Zimbabwe (ZWE), British Virgin Islands (VGB)
To configure the verification process for high-risk clients, follow the instructions outlined below:
Applicant Data Collection: Tax Residence Country, Country, State (Optional), City, Street, Postcode
Identity Document Verification
Supported Document Types: ID Card, Passport
Selfie Verification: Use the Advanced liveness check for selfie verification.
Questionnaire: Select the Basic questionnaire to collect information regarding the client’s financial status.
To apply the required financial questionnaire:
Log in to your Sumsub dashboard.
Create a new questionnaire by importing the provided JSON structure.
Assign the Basic questionnaire to the high-risk verification flow.
JSON
{
"sharedTo": null,
"copyOf": null,
"acknowledged": null,
"id": "paybis_account_due_diligence",
"title": "",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"modifiable": null,
"showTitleAsStepName": null,
"sections": [
{
"id": "purpose_of_account",
"title": "Purpose of Account",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Purpose of Account"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "purpose_of_account_options",
"title": "What is the primary purpose of opening an account with Paybis?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "What is the primary purpose of opening an account with Paybis?"
}
]
},
"desc": "Select all that apply.",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Select all that apply."
}
]
},
"type": "multiSelect",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "purchase_crypto",
"title": "Purchase crypto-assets",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Purchase crypto-assets"
}
]
},
"score": 0
},
{
"value": "sell_crypto",
"title": "Sell crypto-assets",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Sell crypto-assets"
}
]
},
"score": 0
},
{
"value": "exchange_crypto",
"title": "Exchange crypto-assets",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Exchange crypto-assets"
}
]
},
"score": 0
},
{
"value": "long_term_investment",
"title": "Long-term investment",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Long-term investment"
}
]
},
"score": 0
},
{
"value": "personal_savings",
"title": "Personal savings or portfolio diversification",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Personal savings or portfolio diversification"
}
]
},
"score": 0
},
{
"value": "payments_or_transfers",
"title": "Payments or transfers",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Payments or transfers"
}
]
},
"score": 0
},
{
"value": "business_related",
"title": "Business-related transactions",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Business-related transactions"
}
]
},
"score": 0
},
{
"value": "custody_of_crypto",
"title": "Custody of crypto-assets",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Custody of crypto-assets"
}
]
},
"score": 0
},
{
"value": "other",
"title": "Other",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Other"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
},
{
"id": "purpose_of_account_other",
"title": "Please specify other purpose",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Please specify other purpose"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "text",
"required": true,
"format": "min:4",
"condition": "purpose_of_account.purpose_of_account_options=other",
"showCondition": null,
"placeholder": "Type here",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Type here"
}
]
},
"options": null,
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": false,
"randomItemsCount": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": "employment_status",
"title": "Employment Status",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Employment Status"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "employment_status_option",
"title": "What is your current employment status?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "What is your current employment status?"
}
]
},
"desc": "Select one option.",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Select one option."
}
]
},
"type": "select",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "employed_full_time",
"title": "Employed (full-time)",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Employed (full-time)"
}
]
},
"score": 0
},
{
"value": "employed_part_time",
"title": "Employed (part-time)",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Employed (part-time)"
}
]
},
"score": 0
},
{
"value": "self_employed",
"title": "Self-employed",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Self-employed"
}
]
},
"score": 0
},
{
"value": "business_owner",
"title": "Business owner",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Business owner"
}
]
},
"score": 0
},
{
"value": "retired",
"title": "Retired",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Retired"
}
]
},
"score": 0
},
{
"value": "student",
"title": "Student",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Student"
}
]
},
"score": 0
},
{
"value": "unemployed",
"title": "Unemployed",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Unemployed"
}
]
},
"score": 0
},
{
"value": "other",
"title": "Other",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Other"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
},
{
"id": "employment_status_other",
"title": "Please specify your employment status",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Please specify your employment status"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "text",
"required": true,
"format": "min:2",
"condition": "employment_status.employment_status_option=other",
"showCondition": null,
"placeholder": "Type here",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Type here"
}
]
},
"options": null,
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": false,
"randomItemsCount": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": "source_of_funds",
"title": "Source of Funds",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Source of Funds"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "source_of_funds_options",
"title": "What is the source of the funds that you intend to use for transactions through Paybis?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "What is the source of the funds that you intend to use for transactions through Paybis?"
}
]
},
"desc": "Select all that apply.",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Select all that apply."
}
]
},
"type": "multiSelect",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "employment_income",
"title": "Employment income",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Employment income"
}
]
},
"score": 0
},
{
"value": "business_income",
"title": "Business income",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Business income"
}
]
},
"score": 0
},
{
"value": "self_employment_income",
"title": "Self-employment income",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Self-employment income"
}
]
},
"score": 0
},
{
"value": "savings",
"title": "Savings",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Savings"
}
]
},
"score": 0
},
{
"value": "investments",
"title": "Investments",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Investments"
}
]
},
"score": 0
},
{
"value": "crypto_profits",
"title": "Cryptocurrency investments or trading profits",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Cryptocurrency investments or trading profits"
}
]
},
"score": 0
},
{
"value": "dividends",
"title": "Dividends",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Dividends"
}
]
},
"score": 0
},
{
"value": "sale_of_assets",
"title": "Sale of assets or property",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Sale of assets or property"
}
]
},
"score": 0
},
{
"value": "inheritance",
"title": "Inheritance",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Inheritance"
}
]
},
"score": 0
},
{
"value": "gift_or_donation",
"title": "Gift or donation",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Gift or donation"
}
]
},
"score": 0
},
{
"value": "pension_income",
"title": "Pension income",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Pension income"
}
]
},
"score": 0
},
{
"value": "other",
"title": "Other",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Other"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
},
{
"id": "source_of_funds_other",
"title": "Please specify other source of funds",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Please specify other source of funds"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "text",
"required": true,
"format": "min:3",
"condition": "source_of_funds.source_of_funds_options=other",
"showCondition": null,
"placeholder": "Type here",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Type here"
}
]
},
"options": null,
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": false,
"randomItemsCount": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": "expected_volume",
"title": "Expected Monthly Transaction Volume",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Expected Monthly Transaction Volume"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "expected_monthly_volume",
"title": "What is your expected total monthly transaction volume through Paybis?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "What is your expected total monthly transaction volume through Paybis?"
}
]
},
"desc": "Combined value of all transactions.",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Combined value of all transactions."
}
]
},
"type": "selectDropdown",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "Select a range",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Select a range"
}
]
},
"options": [
{
"value": "lt_1000",
"title": "Less than EUR 1,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Less than EUR 1,000"
}
]
},
"score": 0
},
{
"value": "1000_10000",
"title": "EUR 1,000 – EUR 10,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "EUR 1,000 – EUR 10,000"
}
]
},
"score": 0
},
{
"value": "10001_50000",
"title": "EUR 10,001 – EUR 50,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "EUR 10,001 – EUR 50,000"
}
]
},
"score": 0
},
{
"value": "50001_100000",
"title": "EUR 50,001 – EUR 100,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "EUR 50,001 – EUR 100,000"
}
]
},
"score": 0
},
{
"value": "100001_250000",
"title": "EUR 100,001 – EUR 250,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "EUR 100,001 – EUR 250,000"
}
]
},
"score": 0
},
{
"value": "250001_500000",
"title": "EUR 250,001 – EUR 500,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "EUR 250,001 – EUR 500,000"
}
]
},
"score": 0
},
{
"value": "gt_500000",
"title": "More than EUR 500,000",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "More than EUR 500,000"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": "expected_frequency",
"title": "Expected Transaction Frequency",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Expected Transaction Frequency"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "expected_transaction_frequency",
"title": "How frequently do you expect to use Paybis services?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "How frequently do you expect to use Paybis services?"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "select",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "one_time",
"title": "One-time transaction only",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "One-time transaction only"
}
]
},
"score": 0
},
{
"value": "lt_monthly",
"title": "Less than once per month",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Less than once per month"
}
]
},
"score": 0
},
{
"value": "1_to_5_monthly",
"title": "1–5 transactions per month",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "1–5 transactions per month"
}
]
},
"score": 0
},
{
"value": "6_to_20_monthly",
"title": "6–20 transactions per month",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "6–20 transactions per month"
}
]
},
"score": 0
},
{
"value": "gt_20_monthly",
"title": "More than 20 transactions per month",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "More than 20 transactions per month"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true,
"useRandomItems": null,
"randomItemsCount": null
},
{
"id": "pep",
"title": "Politically Exposed Person (PEP) Status",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Politically Exposed Person (PEP) Status"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": [
{
"id": "pep_status",
"title": "Do you currently hold, or have you held within the last 12 months, a prominent public function, or are you a family member or close associate of such a person?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Do you currently hold, or have you held within the last 12 months, a prominent public function, or are you a family member or close associate of such a person?"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "select",
"required": true,
"format": null,
"condition": null,
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "no",
"title": "No",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "No"
}
]
},
"score": 0
},
{
"value": "yes",
"title": "Yes",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Yes"
}
]
},
"score": 0
}
],
"arbitraryDocType": null
},
{
"id": "pep_full_name",
"title": "Full name of the Politically Exposed Person (PEP)",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Full name of the Politically Exposed Person (PEP)"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "text",
"required": true,
"format": "min:2",
"condition": "pep.pep_status=yes",
"showCondition": null,
"placeholder": "Full name",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Full name"
}
]
},
"options": null,
"arbitraryDocType": null
},
{
"id": "pep_relationship",
"title": "Relationship to the PEP (if applicable)",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Relationship to the PEP (if applicable)"
}
]
},
"desc": "Leave blank if you are the PEP yourself.",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Leave blank if you are the PEP yourself."
}
]
},
"type": "text",
"required": false,
"format": "min:2",
"condition": "pep.pep_status=yes",
"showCondition": null,
"placeholder": "e.g. spouse, child, business partner",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "e.g. spouse, child, business partner"
}
]
},
"options": null,
"arbitraryDocType": null
},
{
"id": "pep_position",
"title": "Position held",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Position held"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "text",
"required": true,
"format": "min:2",
"condition": "pep.pep_status=yes",
"showCondition": null,
"placeholder": "e.g. Member of Parliament",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "e.g. Member of Parliament"
}
]
},
"options": null,
"arbitraryDocType": null
},
{
"id": "pep_country",
"title": "Country / Jurisdiction",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Country / Jurisdiction"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "countrySelect",
"required": true,
"format": null,
"condition": "pep.pep_status=yes",
"showCondition": null,
"placeholder": "Select country",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "Select country"
}
]
},
"options": null,
"arbitraryDocType": null
},
{
"id": "pep_period",
"title": "Period during which the position was held",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Period during which the position was held"
}
]
},
"desc": "Format: YYYY-MM to YYYY-MM (or 'present').",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "Format: YYYY-MM to YYYY-MM (or 'present')."
}
]
},
"type": "text",
"required": true,
"format": "min:2",
"condition": "pep.pep_status=yes",
"showCondition": null,
"placeholder": "e.g. 2019-01 to 2024-06",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": "e.g. 2019-01 to 2024-06"
}
]
},
"options": null,
"arbitraryDocType": null
}
],
"delimiter": null,
"useRandomItems": false,
"randomItemsCount": null
}
]
}
UK verification setup
Follow the detailed steps below to configure the verification process for UK-based clients.
Identity Document Verification
Select Live capture as the default method.
Advanced live capture settings:
Capture mode: Set to Both manual and auto capture work at the same time.
Fallback to file upload: Set to Always available.
Supported Document Types: Passport, ID Card, Residence Permit
Selfie Verification: Use Advanced liveness check for enhanced biometric verification.
Applicant Data Collection
Required Fields: Tax Residence Country, Country, City, Street, Postcode, State as optional.
Questionnaire: Use the Risk Warning (PersonalizedRiskWarning) questionnaire to collect risk-related information.
JSON
{
"id": "PersonalizedRiskWarning",
"title": "Risk Warning",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Risk Warning"
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"modifiable": false,
"sections": [
{
"id": "dearClientInvestingI",
"title": "",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": "# ${fullName:Dear Customer}, this is a high-risk investment. How would you feel if you lost the money you’re about to invest? [Take 2 mins to learn more.](https://support.paybis.com/hc/en-us/articles/13873600620317-Risks-associated-with-cryptocurrency-investments)",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": "# ${fullName:Dear Customer}, this is a high-risk investment. How would you feel if you lost the money you’re about to invest? [Take 2 mins to learn more.](https://support.paybis.com/hc/en-us/articles/13873600620317-Risks-associated-with-cryptocurrency-investments)"
}
]
},
"condition": "",
"showCondition": null,
"items": [
{
"id": "yesIUnderstand",
"title": "If you agree to continue, please select the box below & click Next",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "If you agree to continue, please select the box below & click Next"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "bool",
"required": true,
"format": null,
"condition": "",
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": null,
"arbitraryDocType": null
}
],
"delimiter": null
},
{
"id": null,
"title": null,
"localizedTitle": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"desc": null,
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": null,
"showCondition": null,
"items": null,
"delimiter": true
},
{
"id": "doYouWantToContinueW",
"title": "Do you want to continue with the investment journey?",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Do you want to continue with the investment journey?"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"condition": "",
"showCondition": null,
"items": [
{
"id": "pleaseChooseOneOfThe",
"title": "Please choose one of the options below",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Please choose one of the options below"
}
]
},
"desc": "",
"localizedDesc": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"type": "select",
"required": true,
"format": null,
"condition": "",
"showCondition": null,
"placeholder": "",
"localizedPlaceholder": {
"values": [
{
"lang": "en",
"value": ""
}
]
},
"options": [
{
"value": "A",
"title": "Yes, I want to continue with the investment journey",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "Yes, I want to continue with the investment journey"
}
]
},
"score": 0
},
{
"value": "B",
"title": "No, I wish to leave the investment journey",
"localizedTitle": {
"values": [
{
"lang": "en",
"value": "No, I wish to leave the investment journey"
}
]
},
"score": 1
}
],
"arbitraryDocType": null
}
],
"delimiter": null
}
]
}
Integration Overview
The Shared KYC feature of the Paybis API enables your users to avoid repeated identity verification. This is achieved by exchanging the SumSub KYC data between your application and Paybis.
To do this your application will need to do the following:
Confirm with SumSub: confirm with your Sumsub account manager that your pricing plan supports KYC sharing via API.
Send KYC data to Paybis: If you would like Paybis to be the recipient (i.e. receive KYC data from you), you should request a Partner Token from your Paybis Account Manager. Once you receive the token, add Paybis as a recipient in your Sumsub project.
Receive KYC data from Paybis: If you would like Paybis to be the donor (i.e. receive applicants who have completed KYC on Paybis side), you should generate a Partner Token and share it with Paybis so that we can add your company as a recipient.
ℹ️
Applicant Level Consistency: For seamless data transfer, ensure the applicant level (e.g., "Basic Verification Flow") is identical in both the source and destination systems when using the Shared KYC feature. The required verification options are:
Identity Document,
Selfie,
Applicant Data.* Document Configuration: We're standardizing document verification settings to enhance KYC processes. Please request the configuration setup file from your account manager.
Getting a Shared Access Token
Follow the SumSub instructions to generate the re-usable token as explained here. Pass the following values in the forClientId field:
paybis_test- for sandbox testing;
paybis- for production environment.
⚠️
Pay attention on the token expiration time ttlInSecs - set it with enough time period, so that it's not expired at the point of the Request call.
Token Provisioning to Paybis
The token obtained from SumSub needs to be sent to Paybis during the request call. It will trigger the KYC data importing from SumSub.
ℹ️
Note that it’s expected that a shared access token will only be generated for fully verified users. It means that the user's verification is completed and the GREEN result is received from SumSub. Otherwise, the user will be required to pass the verification within the Paybis widget flow.* Make sure to collect the Social Security Number (SSN) during the verification process for US customers. If the SSN is absent in the applicant profile imported via the shared token, the user will be prompted to complete verification within the Paybis widget flow.
Retrieving Shared Access Token from Paybis
If the user completes SumSub verification in the Paybis widget, a shared access token can be requested from Paybis by calling the SumSub Shared Token endpoint. The provided token allows the import of applicant KYC data from SumSub to the partner's system.
ℹ️
Note that you can get updates on the users' verification status changes by implementing the corresponding webhook.
Updated 12 days ago
Single sign-on (SSO)
Set default payment method
Did this page help you?
Yes
No
Copy Page
Understanding Customer Categories and Verification Requirements
Required Data for Basic Verification
Important Notes
Reference for Verification Setup
Basic verification setup
US verification setup
High-risk verification setup
UK verification setup
Integration Overview
Getting a Shared Access Token
Token Provisioning to Paybis
Retrieving Shared Access Token from Paybis