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
| Error Code | Description | Solution |
|---|---|---|
INVALID_API_KEY | API key is invalid or expired | Verify API key in dashboard |
RATE_LIMIT_EXCEEDED | Too many requests | Wait or upgrade your plan |
INVALID_QRIS_FORMAT | QRIS data format is invalid | Upload new QRIS or check format |
QRIS_NOT_FOUND | QRIS ID does not exist | Verify QRIS ID or create new QRIS |
PAYMENT_EXPIRED | Payment window has expired | Generate new QRIS for payment |
VALIDATION_ERROR | Invalid request parameters | Check request body for errors |
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 UUID format
- ✓ 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