S
ShadhinPay Docs

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/v1

Request Format

All requests should:

  • Use HTTPS
  • Include authentication headers
  • Send JSON body for POST/PUT requests
  • Include Content-Type: application/json header

Response Format

All responses follow this structure:

Success Response
{
  "success": true,
  "message": "Operation completed successfully",
  "data": {
    // Response data here
  }
}
Error Response
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": {}
  }
}

Available Endpoints

Rate Limits

EndpointLimit
Payment creation100 requests/minute
Payment status300 requests/minute
Invoice creation60 requests/minute
Other endpoints120 requests/minute

When you exceed the rate limit, you'll receive a 429 Too Many Requests response with a Retry-After header.

On this page