Troubleshooting

Common issues and solutions.

Invalid Signature Error

Problem: Receiving "Invalid signature" error

Solutions:

1. Check that your API secret is correct
2. Verify timestamp is current (within 5 minutes)
3. Ensure signature includes sha256= prefix
4. Verify message construction (method + path + body + timestamp)

Payment Not Found

Problem: "Payment not found" error when retrieving payment

Solutions:

1. Verify payment ID is correct
2. Ensure payment belongs to your merchant account
3. Check that you're using the correct API key

Webhook Not Received

Problem: Not receiving webhook events

Solutions:

1. Verify webhook endpoint is publicly accessible (not localhost)
2. Check webhook URL is registered correctly
3. Verify webhook endpoint returns 200 OK
4. Check webhook logs in dashboard
5. Ensure endpoint responds within 30 seconds

Rate Limit Exceeded

Problem: Receiving rate limit errors

Solutions:

1. Reduce request frequency
2. Implement request queuing
3. Wait until rate limit resets (typically resets every minute)
4. Contact support for higher limits if needed

Insufficient Funds

Problem: Withdraw fails with "Insufficient funds"

Solutions:

1. Check your One2Pays wallet balance
2. Ensure sufficient balance before creating withdraws
3. Wait for incoming payments to settle

Payment Stuck in Processing

Problem: Payment remains in "processing" status

Solutions:

1. Wait a few minutes (some payment methods take time)
2. Check webhook events for updates
3. Poll payment status periodically
4. Contact support if payment is stuck for >30 minutes

Related

• Error Handling
• Webhooks Guide
• API Overview