Developer Guide

Sedicii Webhook Setup

Configure Sedicii to send KYC verification webhooks to your Lumin Identity instance

Webhook Endpoint URL
Use this URL when configuring webhooks in your Sedicii dashboard
https://your-domain.com/api/verify/sedicii/webhook

For local development:

http://localhost:3000/api/verify/sedicii/webhook

💡 For local testing, you'll need a tunneling service like ngrok, Cloudflare Tunnel, or localtunnel

Configuration Steps
Follow these steps to configure webhooks in your Sedicii account
1

Log in to Sedicii Dashboard

Access your Sedicii account at dashboard.sedicii.com

2

Navigate to Webhook Settings

Go to Settings → Webhooks or Integrations → Webhooks in your Sedicii dashboard

3

Add New Webhook

Click "Add Webhook" or "Create New Webhook"

4

Configure Webhook URL

Enter your webhook endpoint URL from above

/api/verify/sedicii/webhook
5

Select Event Types

Choose which events to receive. Recommended events:

  • user.created - New verification session started
  • user.updated - Verification status changed
  • user.completed - Verification completed successfully
  • user.failed - Verification failed
6

Save Configuration

Save your webhook configuration and note any webhook secret or signing key provided

7

Test the Webhook

Use Sedicii's test functionality or trigger a verification to ensure webhooks are received

Webhook Behavior
How the endpoint handles incoming webhooks

Logging Only

All webhook data is logged to the console for monitoring and debugging

No Data Persistence

Webhook data is not saved to a database (currently configured for development)

Immediate Response

Returns HTTP 200 success response immediately to acknowledge receipt

Error Handling

Errors are logged and return HTTP 500 with error details

Important Notes

Security: In production, implement webhook signature verification to ensure requests are from Sedicii

Local Testing: Use a tunneling service (ngrok, Cloudflare Tunnel) to expose your local server to Sedicii

Monitoring: Check your application logs to see incoming webhook data

Retries: Ensure your endpoint returns 2xx status codes to prevent Sedicii from retrying