PF

PayFlow Docs

🔧 Troubleshooting

Troubleshooting Guide

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

Authentication Issues
Problems with API keys and authentication

401 Unauthorized

Problem: API requests return 401 Unauthorized errors

Possible Causes:

  • Invalid or expired API key
  • Missing Authorization header
  • Using test key for live endpoints or vice versa
  • API key doesn't have required permissions

Solution:

  1. Verify your API key is correct
  2. Check the Authorization header format: Bearer YOUR_API_KEY
  3. Ensure you're using the right key for your environment (test vs live)
  4. Check API key permissions in your dashboard
Payment Processing Issues
Problems with payment creation and processing

Payment Creation Fails

Problem: Unable to create payment links or intents

Common Causes:

  • Missing required fields
  • Invalid amount format
  • Unsupported currency
  • Rate limit exceeded

Solution:

  1. Check all required fields are present
  2. Ensure amount is in smallest currency unit (e.g., 2500 for PKR 25.00)
  3. Verify currency is supported (PKR, USD, etc.)
  4. Implement exponential backoff for rate limits

Payment Processing Fails

Problem: Payments fail during provider processing

Solution:

  1. Check payment provider configuration
  2. Verify provider credentials are correct
  3. Ensure provider account is active
  4. Check provider-specific error messages
Webhook Issues
Problems with webhook delivery and processing

Webhooks Not Receiving

Problem: Webhook events are not being delivered to your endpoint

Solution:

  1. Verify webhook URL is accessible via HTTPS
  2. Check your endpoint responds with 200 status
  3. Ensure webhook is active in dashboard
  4. Test with webhook testing tool
  5. Check server logs for incoming requests

Webhook Signature Verification Fails

Problem: Webhook signature verification is failing

Solution:

  1. Check webhook secret is correct
  2. Verify signature calculation matches
  3. Ensure raw body is used for signature
  4. Check for middleware that modifies request body
Performance Issues
Slow response times and performance problems

Slow API Responses

Problem: API calls are taking too long to respond

Solution:

  1. Check your internet connection
  2. Verify you're not hitting rate limits
  3. Use appropriate timeout values
  4. Implement retry logic with backoff

Rate Limiting

Problem: Receiving 429 Too Many Requests errors

Solution:

  1. Implement exponential backoff
  2. Respect Retry-After headers
  3. Cache responses when possible
  4. Batch requests when feasible
Getting More Help
When to escalate and how to get additional support

Still having issues? If you've tried the solutions above and are still experiencing problems, contact our support team with:

  • Detailed description of the problem
  • Steps to reproduce the issue
  • Error messages and logs
  • Your PayFlow account ID
  • What you've already tried
Contact Support