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
- Ensure your redirect_url endpoint is properly handling the code parameter
- 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
- Postman Collection – Test our API endpoints
- GitHub Examples – Code examples and implementations
- Developer Support – Get help with your integration
- Status Page – Check API availability and incidents
This documentation is maintained by the Verifymy’s team. For the latest updates and version history, visit our documentation repository.
on this page
