Troubleshooting

Invalid API Key

If you’re getting 401 Unauthorized errors:

• Verify your API key is correct and not expired
• Ensure you’re using the correct header: API-Key (not X-API-Key)
• Check that your account has been KYC verified
• Confirm your API key has the necessary permissions

Example Request

curl -X GET "https://api.paycrest.io/v1/sender/orders" \
  -H "API-Key: YOUR_API_KEY"

400 Bad Request

Common causes and solutions:

• Invalid amount: Amount must be a positive number
• Unsupported token: Check supported tokens in the resources section
• Invalid network: Ensure the network supports your chosen token
• Missing recipient details: All recipient fields are required
• Invalid institution: Check supported institutions for the currency

Example Error Response

{
  "status": "error",
  "message": "Invalid recipient details",
  "errors": {
    "recipient.accountIdentifier": "Account number is required",
    "recipient.institution": "Institution not supported for NGN"
  }
}

Order Stuck in Pending

If your order has been in pending status for more than 10 minutes:

• Check if there are any network issues or maintenance
• Verify the recipient details are correct
• Contact support with your order ID

Order Refunded

Common reasons for a refund:

• Insufficient provider liquidity
• Recipient account issues
• Compliance or regulatory restrictions
• Network congestion or technical issues

Webhooks Not Receiving

Troubleshooting steps:

• Verify your webhook URL is publicly accessible
• Check that your server returns 200 OK responses
• Ensure your webhook endpoint can handle POST requests
• Verify webhook signature for security

Webhook Signature Verification

const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  );
}

Blockchain Network Problems

If you’re experiencing issues with specific networks:

• High gas fees: Consider using L2 networks like Base, Arbitrum, Polygon, Celo, or Lisk
• Slow confirmations: Some networks may have congestion
• Network maintenance: Check our Telegram community for updates

Supported Networks