Troubleshooting Guide

Common issues and their solutions to help you resolve payment integration problems quickly.

Payment Not Processing

Payments are not being processed or redirected correctly.

Solutions:

  • Verify API keys are correctly configured
  • Check that your payment domain has a valid SSL certificate
  • Ensure webhook URLs are accessible and properly configured
  • Verify payment provider account is active and in good standing
  • Check server logs for error messages

Webhook Not Receiving Events

Webhook notifications are not being received or processed.

Solutions:

  • Verify webhook URL is publicly accessible
  • Check webhook secret is correctly configured
  • Ensure webhook endpoint returns 200 status code
  • Review webhook logs in payment provider dashboard
  • Test webhook delivery using provider's test tools

SSL Certificate Issues

SSL/TLS certificate problems preventing secure connections.

Solutions:

  • Ensure SSL certificate is valid and not expired
  • Verify certificate is properly installed on payment domain
  • Check that all certificate chain files are included
  • Test SSL configuration using online SSL checker tools
  • Contact your hosting provider for certificate support

API Authentication Errors

API requests are being rejected due to authentication issues.

Solutions:

  • Verify API key is correct and not expired
  • Check API key has proper permissions
  • Ensure Authorization header is correctly formatted
  • Verify API key is for the correct environment (test/live)
  • Regenerate API key if necessary

Still Need Help?

If you're still experiencing issues, our support team is here to help. Contact us for personalized assistance.

Troubleshooting Guide - Graphexia Documentation | Graphexia