API Reference

Everything you need. Nothing you don't.

A predictable, REST-y API with JSON everywhere. Sandbox and production endpoints are identical.

Authentication

All API requests use HTTP Basic Auth with your key ID and secret. Never expose your secret key on the client — use publishable keys instead.

curl https://api.nuropayment.com/v1/orders \
  -u "key_id:key_secret"

Create a payment order. The response contains a checkout_url your customer can visit to pay.

POST /v1/orders
{
  "amount":   49900,
  "currency": "INR",
  "method":   "upi",
  "customer": { "email": "anaya@nuro.dev" }
}

Retrieve the status of any payment by its ID.

GET /v1/payments/pay_9f3k2X

Refunds can be partial or full. Refunds are idempotent when you pass an idempotency key.

POST /v1/payments/pay_9f3k2X/refund
{
  "amount": 9900,
  "reason": "customer_request"
}

Every event is signed with your webhook secret. Verify signatures before trusting the payload.

X-Nuro-Signature: t=1720000000,v1=abcd1234...