Error Handling & Troubleshooting

Our API provides descriptive error messages and status codes to help you quickly identify issues.

Common Issues

  • Authentication Errors:
    • Message: "API key is required" or "Invalid API key"
    • Resolution: Ensure your request includes a valid x-api-key header.
  • Quote Expiration:
    • Message: "Quote has expired"
    • Resolution: Make sure to complete transfers within 30 minutes of quote creation.
  • Insufficient Funds or Limits:
    • Message: "Insufficient funds" or "Transaction limit exceeded"
    • Resolution: Check account balances and ensure your transaction does not exceed your KYC tier limits.

Tips for Troubleshooting

  • Check Logs:
    Our API logs detailed error information. Use these logs to pinpoint issues.
  • Review the OpenAPI Spec:
    Verify your request bodies and parameters against our openapi.yaml file.
  • Test in Sandbox:
    Use the sandbox environment to simulate transactions before moving to production.