How to setup KYC verification on deepfabrik with Blockpass

Deepfabrik provides integration with Blockpass KYC services for identity verification. This guide will walk you through the steps to set up your own KYC verification in your deepfabrik-powered portal.

Step 1: Creating a Blockpass Account

1. Go to https://www.blockpass.org/ and click on Get Started

2. Sign up either as a business or as an individual

3. Complete the registration process

Step 2: Creating a KYC service

1. After creating your account, navigate to console.blockpass.org

2. Click on CREATE SERVICE button

3. Select KYC Service (not KYB Service)

4. Configure your service:

   • Service name: Choose a user-friendly name that will be visible to your users

   • Client ID: This is automatically generated and will be used for backend configuration

   • Service logo: Upload your logo (recommended size 512x512px)

5. Click CREATE SERVICE

After creating services they will be visible in the console dashboard.

Note: The Service name can be updated later, but the Client ID cannot be changed.

Step 3: Creating a Webhook

Webhooks allow Blockpass to send verification updates to your deepfabrik instance.

1. From the Blockpass dashboard, click on your newly created service

2. In the left sidebar, navigate to Webhooks > Settings

3. Click CREATE WEBHOOK

4. Configure your webhook:

   • Name: A descriptive name (for your reference only)

   • Endpoint: This must match your deepfabrik domain with the path /api/kyc-blockpass-webhook appended

     • Example: If your site is investor.web3service.com, the endpoint should be investor.web3service.com/api/kyc-blockpass-webhook

   • Endpoint Secret: Create a strong secret key (similar to a password). The secret acts as a password that is used to make sure nobody can send fake requests to your services. This is required to be set for deepfabrik. A good value here is similar to a good password.

   • Events: Click "See More" and select all available event boxes. This allows the users to see the different states of their KYC process.

5. Click CREATE

Step 4: Providing configuration values to deepfabrik

After setting up your Blockpass service and webhook, contact the deepfabrik team and provide us with:

1. The Client ID of your service (created in Step 2)

2. The Webhook Endpoint Secret (created in Step 3)

We will then configure your instance to communicate with your Blockpass account.

User experience

Once integrated, your users will be able to complete KYC verification directly through your deepfabrik platform. The process will show various states (pending, in review, approved, rejected) based on the webhook events you've enabled.

Troubleshooting

If you encounter issues with the KYC process:

• Verify that all webhook events are properly selected

• Ensure the webhook endpoint exactly matches your deepfabrik instance URL plus the required path

• Check that the Client ID and Endpoint Secret have been correctly provided to the deepfabrik team

For additional assistance, contact the deepfabrik support team.