创建您的首笔支付

创建支付，将客户引导至结账页面，并通过 webhook 确认结果。本指南使用您的 API 密钥，端到端操作大约需要五分钟。

开始之前

您需要商户 API 密钥，以及能够接收 webhook 的 HTTPS POST 请求的服务器。请将 API 密钥保存在服务器上，切勿放入客户端代码中。

1. 创建支付会话

使用整数卢比金额向 /payments/session 发送 POST 请求。amount 必须介于 ₹500 和 ₹99,000 之间。

curl -X POST https://api.xenonpay.net/api/payments/session \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "amount": 500,
    "order_id": "order-123",
    "customer_name": "Asha Sharma"
  }'

在 Node.js 中：

const res = await fetch("https://api.xenonpay.net/api/payments/session", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.XENONPAY_API_KEY,
  },
  body: JSON.stringify({
    amount: 500,
    order_id: "order-123",
    customer_name: "Asha Sharma",
  }),
});
const session = await res.json();
// session.checkout_url is where you send the customer

调用成功后会返回 201，其中包含 checkout_url、session_token 和已分配的 UPI 详细信息。

2. 将客户引导至结账页面

将客户重定向到响应中的 checkout_url。客户将在该页面通过 UPI 完成支付，并提交其交易参考号。支付会话将在创建后 10 分钟过期。

3. 接收 webhook

支付确认后，我们会向您配置的 URL 发送 SUCCESS webhook。请将此视为支付完成的时刻。在信任任何 webhook 之前，请验证每个 webhook 的签名。

4. 仅在需要时轮询状态

如果您错过了 webhook，可以在其速率限制范围内，通过 GET /payments/session/{session_token} 检查当前状态。

这对您有帮助吗？