Transformer - Cross Border Transfer Why am I getting a 401 Unauthorized error?# This typically means your x-api-token is missing, invalid, or expired. Double-check the token in your headers. If the issue persists, rotate the token or contact support. Why is my webhook not triggering?# You have registered your webhook correctly using PUT /utility/webhook.
Your endpoint returns a 2xx response.
You're subscribed to the correct event type (e.g., kyc.transitioned, transfers.status).
Why is the status of my KYC stuck in reviewing?# KYC verifications can take time depending on jurisdiction. If it’s pending for more than 24 hours, contact compliance@zynk.money for escalation. My webhook returns 200 but I’m still not seeing events. What should I check?# Confirm that your webhook URL matches the one registered.
Check that you are listening for the correct event types.
Ensure the body parser on your server handles application/json.
Check logs for timestamp drift or expired signatures.
I'm receiving duplicate webhook events. Is this normal?# Yes, webhook retries can happen. Make your webhook handler idempotent — always check eventId or txnHash before processing. How can I debug webhook signature verification errors?# You’re using HMAC-SHA256 with your x-api-token as the secret.
The payload and timestamp are concatenated exactly as specified.
You're not modifying the payload before verification.
What should I do if I get 500 Internal Server Error?# This usually indicates a backend issue. Try: Retrying the request with exponential backoff.
Logging the full response body.
Contacting support with request ID, timestamp, and payload for analysis.
Modified at 2025-11-14 15:18:08
