Paytroz

Everything you need to go live

Comprehensive documentation, SDKs, and support to get you from API key to production.

Get Sandbox AccessView Quickstart

API Reference

Complete API documentation with examples

SDKs

Official libraries for Node.js, Java, Python

Status

Real-time API status and uptime

Quickstart

Get started in minutes

Create your first payment with just a few lines of code.

Authentication

All API requests require authentication via Bearer token in the Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Idempotency

Include an Idempotency-Key header to safely retry requests:

Idempotency-Key: <UUID>

Create a Payment

# Create a payment
curl -X POST https://api.paytroz.com/v1/payments \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 49900,
    "currency": "INR",
    "method": "upi",
    "metadata": {"order_id": "ORD-123"}
  }'

Sandbox Environment

Use test API keys for development. No real transactions will be processed.

Base URLhttps://sandbox.api.paytroz.com

Webhooks

Receive real-time notifications for payment events.

Available Events

payment.succeeded

Payment completed successfully

payment.failed

Payment attempt failed

refund.processed

Refund successfully processed

refund.failed

Refund attempt failed

Example Payload

{
  "event": "payment.succeeded",
  "timestamp": "2025-10-02T14:30:00Z",
  "data": {
    "payment_id": "pay_abc123xyz",
    "amount": 49900,
    "currency": "INR",
    "status": "succeeded",
    "method": "upi",
    "gateway": "razorpay",
    "metadata": {
      "order_id": "ORD-123"
    }
  },
  "signature": "sha256_hmac_signature_here"
}

Refunds

Process full or partial refunds programmatically.

curl -X POST https://api.paytroz.com/v1/payments/pay_abc123/refund \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 49900,
    "reason": "customer_request"
  }'

Need Help?

Our team is here to help you integrate and scale.

Developer Support

Get help from our engineering team via email or Slack.

Community

Join our developer community for discussions and updates.