Consumer due diligence and KYC
ConsumersConsumers Individual persons who can be onboarded as identities on Weavr. Consumer identities represent individual customers and require Know Your Customer (KYC) verification. For consumers, the card owner and card assignee are typically the same person. being onboarded need to complete KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. (Know Your Customer) before they can use any financial service. This involves submitting due diligence information and documents through our web KYC component, which embeds the entire verification flow in your app so the consumer doesn't need to leave it.
The KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. component is available for web apps. It is not supported in the mobile SDKs.
What we collect
The first screen shown in the KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. UI component requires the consumer to view and consent to the Terms and Conditions, before the actual due diligence process is initiated.

The following information is captured as part of the standard due diligence process:
- Identity document (for example, a copy of the ID card or passport)
- Liveness check (selfie)
- Proof of address (for example, a recent copy of a utility bill or a bank statement)
The following documents are accepted as proof of address for individuals:
- Bank or card statements, mortgage statements, formal bank letters
- Utility bills (water, electricity)
- Internet, cable TV, or house phone line bills
- Tax returns
- Council tax bills
- Driving license showing the address
- Residence permit showing the address
- Official government-issued documentation, tax certificates, certifications, and similar
Provided documents must not be older than 3 months.
Start KYC
Prerequisites
KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. can start only after the consumer's root userRoot user The individual who creates the identity. For corporate identities, the root user needs to be a legal representative of the corporate such as a director or a representative who has the power of attorney over the company. For consumer identities, the root user is the owner of the identity. Every identity must always have one root user. has verified their email address. Attempting to start KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. before email verification completes results in an error.
Trigger the KYC process
Call the API to trigger KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers.:
- Request
- Response
{
"kycLevel": "KYC_LEVEL_1",
"prefillDetails": [
{
"name": "string",
"value": "string"
}
]
}
{
"reference": "string",
"kycLevel": "KYC_LEVEL_1"
}
The response body contains a reference parameter. Use this value to initialize the KYC UI component.
You can get updates on the consumer's KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. status by listening to the consumer KYC webhook. For more information on integrating with our webhooks, see the webhooks guide.
Retrieve the KYC status of a consumer
To determine the KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. status of a consumer, call:
- Response
{
"fullDueDiligence": "NOT_STARTED",
"kycLevel": "KYC_LEVEL_1",
"ongoingFullDueDiligence": "NOT_STARTED",
"ongoingKycLevel": "KYC_LEVEL_1"
}
The fullDueDiligence field returns the KYCKYC Know Your Customer - the identity verification process for consumer identities. This process allows you to seamlessly and securely verify your user's identity. Weavr will ask users to submit the necessary information and documentation so that they can get approved by financial providers. status for the consumer.