Troubleshooting Guide

If you're encountering issues with integrating the Waga API, particularly with registering a payment order or checking the payment order status, use this guide to diagnose and resolve common problems.

Register Payment Order

1. Invalid API Key

Issue: You receive a 401 Unauthorized error when attempting to register a payment order.

Solution:

• Check API Key: Ensure you are using the correct API key. Verify that it is correctly set in your request headers.
• API Key Permissions: Make sure the API key has the necessary permissions for the operation you're trying to perform.
• Regenerate API Key: If the key might be compromised or outdated, regenerate it from the Waga dashboard and update it in your application.

2. Bad Request Error

Issue: You encounter a 400 Bad Request error.

Solution:

• Validate Request Body: Ensure that all required fields are included and correctly formatted. Check for typos and missing fields.
• Field Values: Confirm that values for fields like amount, currency, and order_number meet the API’s requirements.
• Payload Format: Verify that the request body is properly formatted as JSON and matches the expected schema.

3. Incorrect Return URL

Issue: The return URL does not redirect as expected after payment.

Solution:

• Check URL Validity: Ensure the return_url provided is correctly formatted and accessible.
• URL Encoding: Confirm that the URL is properly encoded and does not contain any special characters that might cause issues.

4. Request Timeout

Issue: The request to register a payment order times out.

Solution:

• Server Status: Check if Waga's servers are operational by visiting the status page or contacting support.
• Network Issues: Investigate any network connectivity issues on your end that might be causing delays.
• Increase Timeout: Adjust the timeout settings in your HTTP client or server configuration if necessary.

Check Payment Order Status

1. Order Not Found

Issue: You receive a 404 Not Found error when checking the payment order status.

Solution:

• Verify Order Number: Ensure that the order_number you are querying exists and is correct.
• Check Endpoint: Confirm that you are using the correct endpoint for checking the payment status.

2. Unauthorized Access

Issue: You receive a 401 Unauthorized error when querying the status.

Solution:

• Check API Key: Ensure the API key used for the request is valid and has access to the status endpoint.
• API Key Permissions: Verify that the key has the necessary permissions for querying order status.

3. Incorrect Status Response

Issue: The status response is not as expected or contains incorrect information.

Solution:

• Validate Response Parsing: Ensure that your application correctly parses the API response and handles different status values.
• Check API Documentation: Review the API documentation to understand the possible status values and their meanings.
• Update Logic: Adjust your logic for interpreting status responses based on the latest API documentation.

4. Response Delay

Issue: The status response is delayed or takes longer than expected.

Solution:

• Check Server Load: Verify if Waga’s servers are experiencing high traffic or performance issues.
• Network Latency: Assess network latency or connectivity issues on your side that may be contributing to delays.
• Retry Logic: Implement retry logic with exponential backoff in case of intermittent delays or timeouts.

Additional Resources

• Waga Support (opens in a new tab)

• Contact Us (opens in a new tab)

If you continue to experience issues or need further assistance, please contact Waga support. We’re here to help ensure your integration is successful.