Error Handling

Error Handling & Troubleshooting

HTTP Status Codes

Success Responses:

• 200 OK - Request successful
• 201 Created - Resource created successfully

Client Error Responses:

• 400 Bad Request - Invalid parameters or malformed JSON
• 401 Unauthorized - Invalid or missing API key
• 403 Forbidden - Insufficient permissions
• 404 Not Found - Resource not found
• 429 Too Many Requests - Rate limit exceeded

Server Error Responses:

• 500 Internal Server Error - Unexpected server error
• 503 Service Unavailable - Service temporarily unavailable

Common Errors & Solutions

Troubleshooting Guide

Authentication Issues

Problem: 401 Unauthorized

• ✓ Check if API key is included in X-API-Key header
• ✓ Verify API key is active in your dashboard
• ✓ Ensure no extra spaces or characters in API key
• ✓ Use HTTPS instead of HTTP

Rate Limiting Issues

Problem: 429 Too Many Requests

• ✓ Implement exponential backoff in your retry logic
• ✓ Check Retry-After header for wait time
• ✓ Consider upgrading to higher tier for increased limits
• ✓ Batch requests when possible to reduce API calls

QRIS Generation Issues

Problem: Invalid QRIS Format

• ✓ Ensure amount is a positive number
• ✓ Verify QRIS ID is a valid number
• ✓ Check output_type matches your subscription plan
• ✓ Validate all required fields are provided

Best Practices

• ✓ Always check the success field in responses
• ✓ Implement proper error handling for all status codes
• ✓ Use HTTPS for all API requests
• ✓ Monitor your API usage in the dashboard
• ✓ Set up webhooks and install the Listener Application

Support & Contact

Get help, report issues, and connect with our developer community and support team.

Documentation

• Comprehensive guides and tutorials
• Getting Started Guide
• Integration Examples
• Best Practices
• FAQ & Troubleshooting

Technical Support

Email Support (24/7)

support@rajaongkir.com

More Information

Need Help?

For questions about integration or the API, hit the live chat. Our team's on standby.

Open Live Chat