Search Overlay

Customer Verification



KYC or Know Your Customer standards and procedures are established to protect financial organizations against fraud, money laundering, and terrorist financing.

The core of the KYC process is confirmation of the customer’s identity, understanding the customer’s behavior and source of funds, and assessing money laundering risk.

Core terms of KYC as a service:

ID – identity verification or confirmation of the legitimacy of provided personal information of the end customers. The provided personal data is compared to the identity verification document owned by the customer.

AV – address verification or confirmation of residency of end customers based on provided legit address documents.

Face verification – comparison of the end customer's face or biometric data to provided documents or in other words confirmation of ownership of the account.

PEP screening - screening over politically exposed individuals, meaning people with political roles or entrusted with public functions, including their relatives.

Sanction screening - screening over people, or organizations, engaged in illegal activities. Sanction Lists are published by Governments and International authorities.

The Paysafe KYC solution is part of the Embedded Wallet product and it is a designed to perform Customer Due Diligence on a variety of levels and there allows businesses to meet compliance requirements.

Our KYC solution allows you to onboard and verify your customers.

Part of our primary responsibilities as an Embedded Wallet are KYC, PEP and Sanctions, Risk, and AML monitoring executed by the name of the merchant, which can ensure the legitimate purposes of customer's account creation and payment processing.

Paysafe KYC via UI Application

In that sense, our KYC solution can provide a complete UI flow for collecting a customer's verification documents and verify their identity and address.

As previously explained Digital Wallet is a service concept in which each customer is assigned to a wallet. The customer's onboarding is followed by the mandatory KYC process.

The verification process includes two main steps – ID verification and Address verification.

ID verification

ID verification is designed to verify the Identity of the customer and their biometrics. The two main ways are via ID document and a selfie or via electronic verification. The methods might vary depending on various factors.

To submit their ID document, customers can take webcam images of the document, upload existing image files from their device(This functionality might be disabled depending on various factors.) or switch to their mobile phone and use the phone's camera to take images.

KYC ID Verification step

The customer is requested to take a photo of themselves to ensure that they possess the provided documents.

Address verification

The second part of the verification process is the AV step which requests the customer to upload a document for address confirmation (the type of documents and their requirements are explained to the customer when the AV step is initiated). This step can also be completed via electronic verification.

KYC Address Verification step

Integration with the Paysafe KYC Application

Diagram: Paysafe KYC UI app integration

  1. Customer initiates the KYC verification process by clicking on the Verify your identity(or your equivalent) button in your APP.

  2. Your app calls the Paysafe API with the help of the Paysafe SDK to create a KYC verification session.

    import { Wallet } from '@paysafe/paysafe-wallet-saas-web/wallet';
      .then((response) => {
        // Handle response
  3. The response contains the redirectUrl to be used for redirecting the customer to the Paysafe KYC UI app.

      "sessionId": "8422d64e-4f16-4c41-a36f-f1f11c425f2e",
      "redirectUrl": "<paysafe-kyc-ui-app>"
  4. In your application open the redirectUrl in an iframe.

    const iframe = document.createElement('iframe');
    iframe.src = response.redirectUrl;
  5. Customer goes through the verification process in the Paysafe Kyc UI app

  6. When the customer completes the flow the Paysafe KYC UI app navigates the customer back to the provided by you returnUrl.

  7. You may handle the return flow by getting the KYC session status and deciding where to take your customer.

KYC Verification session

The diagram below shows the verification session lifecycle.

KYC Session lifecycle

The session begins when the Merchant APP creates a kyc session using the Paysafe SDK. At this moment the session will be with status CREATED and will be expecting initiation. Initiation happens when the customer is redirected to the sessionUrl provided. Once the customer sucessfully opens the Paysafe KYC UI, the session status is changed to INITIATED. If the customer fails to open the session url or otherwise initiate the session, after a certain time periond the session will be considered abandoned and the status changed to ABANDONED.

In an initiated session, the customer will be asked to provide various information in order to achieve the desired level of verification. Should the customer go through all of the required steps, they will be redirected and the status of the session will be changed to COMPLETE. Failing to go through all the steps in a timely manner, the session will expire and the status will be changed to EXPIRED.

COMPLETE, ABANDONED and EXPIRED are all final statuses, meaning that the customer cannot interact with the KYC Application within that session. Once a session receives a final status, a webhook will be issued containing details of the verification session.

Getting customer Kyc verification status

You can check your customers' Kyc verification status by calling the following endpoint GET

  "customerId": "123456",
  "externalId": "dfc3ab16-41d9-43ea-849b-f56c05c91d5e",
  "kycVerificationStatus": "COMPLETED"

Alternatively, you can use the SDK's method of getKycStatus.

import { Wallet } from '@paysafe/paysafe-wallet-saas-web/wallet';

  .then((response) => {
    // Handle response

KYC Webhooks

You will be notified via a webhook only after the session concludes. The following notification will be sent to your callback URL. You'll also be receiving webhooks should the status of verification documents changes. An example of this would be:

  1. Customer uploads a document
  2. The document is being processed
  3. Customer completes the verification flow successfully
  4. You'll receive webhook notifying you of the session end. The message will also include the status of the document, in this case it will be IN_REVIEW or UPLOADED.
  5. Once the document has been reviewd by us, you'll receive another webhook with the updates status of the document and the updates verification status of your customer.
On this Page