VerifyHQ Docs

Migration Guide

Migrating from another KYC provider? This guide covers common migration patterns.

Migration Steps

  1. Create your VerifyHQ account and generate non-production API keys
  2. Map your existing endpoints to VerifyHQ equivalents (see table below)
  3. Update webhook handlers — event names and payload formats differ
  4. Test with non-production keys and local fixture users
  5. Run parallel — send verifications to both providers during transition
  6. Switch production traffic once validation passes

Common Provider Mapping

ParameterTypeDescription
Create verificationmappingPOST /verifications/identity
Upload documentmappingPOST /verifications/document (multipart)
Check livenessmappingPOST /verifications/liveness/session → /challenge flow
Get statusmappingGET /verifications/identity/:id
Webhook setupmappingPOST /webhooks/configure
Need help migrating? Contact support@verifyhq.com for dedicated migration assistance.