API Reference
Complete reference documentation for the ShadhinPay REST API
API Reference
This section provides detailed documentation for all ShadhinPay API endpoints.
Base URL
Production: https://api.shadhinpay.com/api/v1
Sandbox: https://sandbox.shadhinpay.com/api/v1Request Format
All requests should:
- Use HTTPS
- Include authentication headers
- Send JSON body for POST/PUT requests
- Include
Content-Type: application/jsonheader
Response Format
All responses follow this structure:
{
"success": true,
"message": "Operation completed successfully",
"data": {
// Response data here
}
}{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Human-readable error message",
"details": {}
}
}Available Endpoints
Payments
Create and manage payments
Invoices
Generate and send invoices
Webhooks
Webhook events and signatures
Errors
Error codes and handling
Rate Limits
| Endpoint | Limit |
|---|---|
| Payment creation | 100 requests/minute |
| Payment status | 300 requests/minute |
| Invoice creation | 60 requests/minute |
| Other endpoints | 120 requests/minute |
When you exceed the rate limit, you'll receive a 429 Too Many Requests response with a Retry-After header.