Zapier Webhooks & iDenfy API Integration

Purpose

Webhooks by Zapier enables seamless access to iDenfy API endpoints, requiring minimal programming knowledge. This integration supports services such as:

• KYC (Know Your Customer)
• AML (Anti-Money Laundering)
• Potentially KYB (Know Your Business)

Key Concepts to Understand

Initiating KYC Verification and Receiving Results are two distinct steps. Each step involves specific API interactions outlined below.

1. Creating a Verification Session

To initiate verification, you'll need to generate a verification token using the designated API endpoint.

1. Set up the initial trigger in Zapier.
2. Add a new action step for Webhooks by Zapier.
   • App: Search for "Webhooks by Zapier."
   • Action Event: Select "Custom Request."

3. Configure the Request:

   • Method: As described in the iDenfy documentation.
   • URL: Enter the endpoint URL from the iDenfy documentation.
   • Data: Input required parameters. You can map data from earlier steps in the Zap.
   • Basic Authentication: Use your iDenfy API credentials in the format: API Key|API Secret (e.g., key123|secret@#$123).

4. When configured successfully, this step generates a verification token.

2. Generating a Verification Link

To create a unique verification link for a client:

1. Generated Auth Token: qvTJBSd2SAKKILKdMCVRxptzaRJEzkRMvoUBFSQs
2. Append the generated Auth Token to the base URL: https://ivs.idenfy.com/api/v2/redirect?authToken=
3. Example: https://ivs.idenfy.com/api/v2/redirect?authToken= qvTJBSd2SAKKILKdMCVRxptzaRJEzkRMvoUBFSQs

info

Once this link is created, it can be included in:

• Automated emails
• Notifications
• etc.

This inclusion depends on your integrations.

3. Receiving Verification Results

You can configure Webhooks by Zapier to receive results as notifications.

1. Create a New Zap and select the trigger event Catch Hook.
2. In Configure leave the Pick off a Child Key field empty.
3. Copy the URL from Your webhook URL section.

1. Set up notification in iDenfy dashboard.

2. You will receive information in parsed fields, which you can use according to your needs.

4. Using AML Services

For AML, follow the same steps as "Creating a Verification Session."

• Use the API endpoint provided in the documentation, specifically in the section about AML.
• Using the Data section on examples in the documentation, configure the AML search to match your needs.

note

Important! The results will be returned in the same request.

Request example:

Response in a same step example:

Best Practices

• Always refer to the latest iDenfy API documentation.
• Securely manage API credentials.
• Test webhook configurations thoroughly.
• Implement robust error handling.