Where Every Settlement Tells the Truth
0%
Developers

API-First.
Built for Builders.

PathPay's RESTful API lets you embed automated deduction infrastructure into any product in minutes.

RESTful API

Clean, predictable endpoints with full OpenAPI documentation and sandbox testing environment.

Webhooks

Real-time event notifications for every deduction, settlement, and contract state change.

SDKs

Official SDKs for Node.js, Python, PHP, and Java — with code samples and quick-start guides.

Sandbox Environment

Full sandbox with simulated POS settlements and deduction flows for testing before go-live.

POST /v1/contracts Copy 
curl -X POST https://api.pathpay.net/v1/contracts \
  -H "Authorization: Bearer pp_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "merchant_id": "mer_9x2k8s",
    "creditor_id": "crd_4m7n3p",
    "deduction_type": "percentage",
    "deduction_rate": 0.15,
    "total_amount": 50000,
    "currency": "SAR",
    "consent_required": true
  }'

// Response
{
  "contract_id": "con_7g4h2j",
  "status": "pending_consent",
  "otp_sent": true,
  "created_at": "2026-05-21T09:41:22Z"
}