XenonPay API 简介

XenonPay API 可让您向印度客户收取 UPI 支付。您创建支付会话，将客户引导至托管结账页面完成支付；支付确认后，我们会立即通知您的服务器。

支付流程

每笔支付都会经历相同的五个阶段，从您首次调用 API 到资金到账。

1. 您调用 API，为指定的 amount 创建一个 支付会话。

2. 将客户引导至我们返回的 checkout_url。

3. 客户通过 UPI 支付，并在结账页面提交其交易参考号（UTR）。

4. 我们将收到的入账与该会话进行匹配，将其标记为 SUCCESS，然后向您的服务器发送经过签名的 webhook。

5. 该笔支付会计入您的下一次结算，并按照您的结算计划支付到您的银行账户。

基础 URL

所有 API 请求都发送到同一个基础 URL：

https://api.xenonpay.net/api

例如，创建支付会话需要向 https://api.xenonpay.net/api/payments/session 发送 POST 请求，检查其状态需要向 https://api.xenonpay.net/api/payments/session/{session_token} 发送 GET 请求。

身份验证

服务器到服务器的请求使用您的商户 API 密钥进行身份验证，并将其放在 x-api-key header 中。请将此密钥保存在您的服务器上，切勿在客户端代码中公开。您的 API 密钥及其撤销机制详见身份验证。

金额和货币

所有金额均以整数印度卢比表示——不包含派士，也不包含小数。每笔支付的最低金额为 ₹500，最高金额为 ₹99,000。您发送的每个 amount 以及我们返回的每个 amount 都是整数卢比数值，货币始终为 INR。

获取支付最新状态

使用 webhooks 作为判断支付成功、失败或过期的事实依据。我们会为每个 webhook 签名，以便您验证其确实来自我们。您也可以在速率限制范围内轮询状态端点，作为备用方案。这两种方式均在本文档中介绍。