Reusable KYC (Shared KYC) Previous
Paybis allows you to avoid repeated KYC for your verified customers:
- On a per-transaction basis (without data sharing)
- On a per-user basis (with applicant data sharing).
If a KYC provider other than Sumsub is in use, Trusted KYC provides an option to bypass KYC verification on Paybis for the users that have already been verified on a per-transaction basis.
Please note that this feature is not automatically enabled; it is accessible to specific partners who have undergone additional compliance review and signed a separate addendum to the main agreement.
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.
Shared KYC
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 plus Proof of Source of Funds (SOF).
- UK: Paybis will always request KYC, regardless of partner verification.
Required Data for Basic Verification
The following personal information is required:
- First Name,
- Last Name,
- Date of Birth,
- Nationality,
- Country of Residence,
- Residential Address (including street, city, postal code, and country).
The following identity verification information is required:
- Government-issued ID document (e.g., passport, driver's license),
- 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.
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 Paybis: Receive confirmation from your Paybis integration manager that the Shared KYC model will be supported in your use case. This is done during the onboarding process.
- Generate a Shared Access Token: Generate a shared access token via SumSub.
- Send Token to Paybis: Send the shared access token to Paybis during your application's interaction with the Paybis backend.
Getting a Shared Access Token
Follow the SumSub instructions to generate the shared access 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 in 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.
Trusted KYC
The Trusted KYC feature allows our partners to run the widget bypassing the customer verification when such customers are already verified with the partner. This feature will skip the KYC step altogether without the need to share clientโs verification data at the time of the transaction.
Prerequisites
This feature is only available to certain partners who have gone through additional compliance review and signed a separate addendum to the main agreement. To request this feature, speak to your account manager.
Trusted KYC flow
- Check that the user is verified in your system.
- Call the POST /request endpoint with the
trustedKyc
flag set totrue
.- Add the required information to
trustedKycInfo
object (optional).
- Add the required information to
- Start the widget with the retrieved
requestId
. - User can complete their journey in the widget bypassing KYC verification regardless of the transaction amount.
Extension for Trusted KYC
Extension for trusted KYC allows our partners to provide users' personal data (KYC-related information) during the widget integration process.
trustedKycInfo
is an optional object that is utilized as a part of the Trusted KYC option only.
It aims to improve:
- Compliance Process: Sharing additional user data AML/KYC compliance, ensuring a secure platform.
- Success Rates: Providing extra user details can increase success rates for certain payment methods, reducing chargebacks.
Parameter | Required | Description | Comment |
---|---|---|---|
firstName | mandatory | User's first name | |
lastName | mandatory | User's last name | |
dateOfBirth | mandatory | User's date of birth. Date only (ISO 8601 format) | |
country | mandatory | 2-symbol ISO country code | |
state | optional | 2-symbol state code. | Required if country equalsUS |
address | optional | User's address line | |
city | optional | User's city of residence | |
zip | optional | User's postal code | |
phone | optional | User's phone number | |
documentType | optional | User's identification document type | documentType is required for PIX/SPEI to improve the success rateList of options: - PASSPORT - DRIVERS_LICENCE - IDENTITY_CARD - RESIDENCE_PERMIT |
documentNumber | optional | User's identification document number | documentNumber is required for PIX/SPEI to improve the success rate |
Please ensure that the trustedKyc
flag is included in each request. Adding it once does not impact the user's verification status in the Paybis system.
Updated 2 months ago