Troubleshooting
This section provides solutions to standard integration issues and helpful debugging tips.
HMAC Authentication Failures
- Ensure your API key and secret are correct
- Verify that you’re using the exact request body for HMAC calculation
- Check that your HMAC header format is correct:
hmac {api_key}:{hmac_signature}
💡 Tip
If you’re having trouble with HMAC authentication, try using our SDK which handles HMAC calculation for you.
Redirect URL Unauthorized
- Make sure the redirect_url is registered in your allowed redirect URLs
- Check for exact matching including protocol (http/https) and trailing slashes
⚠️ Common mistake
Verification Flow Interruptions
- Verify that your server can make outbound HTTPS requests
- Check that your server’s IP is not blocked by any firewall
💡 Testing tip
Use our Postman collection to verify each step of the flow independently.
API Error Codes
Common error status codes and their resolutions:
| Status | Error | Resolution |
|---|---|---|
400 |
Bad Request |
Check that your request format and parameters are correct |
401 |
Unauthorized |
Verify API credentials and HMAC signature |
403 |
Forbidden |
Your credentials are valid but you lack permission for this action |
429 |
Too Many Requests |
Implement rate limiting in your application |
500 |
Server Error |
Contact support with your request details and timestamp |
Additional Resources
- Status Page – Check API availability and incidents
- Try using our SDK which handles the bulk of the work for you.
- Still having trouble? Contact your onboarding manager for support.
This documentation is maintained by the Verifymy’s team. For the latest updates and version history, visit our documentation repository.
on this page
