Introduction to the XenonPay API

The XenonPay API lets you collect UPI payments from your customers in India. You create a payment session, send your customer to a hosted checkout page to pay, and we notify your server the moment the payment is confirmed.

How a payment works

Every payment moves through the same five stages, from your first API call to money reaching your account.

1. You call the API to create a payment session for a specific amount.

2. You send your customer to the checkout_url we return.

3. Your customer pays over UPI and submits their transaction reference (UTR) on the checkout page.

4. We match the incoming credit to the session and mark it SUCCESS, then send a signed webhook to your server.

5. The payment is included in your next settlement and paid out to your bank account on your settlement schedule.

Base URL

All API requests go to a single base URL:

https://api.xenonpay.net/api

For example, creating a payment session is a POST to https://api.xenonpay.net/api/payments/session, and checking its status is a GET to https://api.xenonpay.net/api/payments/session/{session_token}.

Authentication

Server-to-server requests authenticate with your merchant API key, sent in the x-api-key header. Keep this key on your server and never expose it in client-side code. Your API key and how revocation works are covered in Authentication.

Amounts and currency

All amounts are in whole Indian rupees — no paise, no decimals. The minimum payment is ₹500 and the maximum is ₹99,000 per payment. Every amount you send and every amount we return is a whole-rupee number, and the currency is always INR.

Staying up to date on a payment

Use webhooks as your source of truth for when a payment succeeds, fails, or expires. We sign every webhook so you can verify it came from us. You can also poll the status endpoint as a fallback, within its rate limit. Both approaches are covered in these docs.