Rspay OpenApi

Appearance

📦 Changelog ​

记录每次文档更新的内容、时间和变更类型。

🗓️ 2025-07-17 ​

✨ 代付回调地址由接口传参改为固定地址，同时接口传参仍旧保留 ​

需要提供固定回调地址让我们添加，另外拉单时传递的代付回调地址必须和提交给我们的固定地址保持一致，否则会拉单失败

✨ 新增代付签名生成方法与相关描述 ​

  • 详情参见 基础信息 - 生成代付请求签名

✨ 新增 代付请求字段 ​

  • 代付请求头新增参数 X-Timestamp，签名时也需要使用此值
python
import time
x_timestamp = time.time_ns() // 1000000
JS
const x_timestamp = Date.now();
java
long x_timestamp = System.currentTimeMillis();
php
$x_timestamp = floor(microtime(true) * 1000);
  • 代付请求体新增参数 signature, 生成签名参见 基础信息 - 生成代付请求签名
json
{
  "clientId": "3548947916558",
  "currency": "INR",
  "amount": 100,
  "payMethod": "104001",
  "name": "auog",
  "phone": "8541236971",
  "email": "845623@21cn.com",
  "callbackUrl": "http://callback.com",
  "indiaBank": {
    "accountNo": "01415659",
    "ifsc": "12345678951"
  },
  "signature": "I3SA71LbT5+h8rvB1d4/MdJj9xlfpk9ZuezvBn4zfzq9jvlb+vqkovZOYwad4AQ0wzXsR8X5rmtpXW/hIW0oUSvodDiDTJMpLG7D2b40dkQ7kX3RSIvVUHRxBM+YmfxxyWdGXirwv85L4r5NLZNO58OptXSCeeLy809aZkwQSsBO0aGVRiSKXRHa1r3gCizO569mAaos72S9w1olYRXQ0JvlmzpvDv/QAHKukNe00T5NpuEfedn4HOvGCoXujelgSq7A/QJ47+7PMFlUowVVYJ1lD7YeItuDsNQnFCS/R8OfKv5NX/m9JiKMQdjPUZuIodwf4PrhPnx3eDn/nhBe7w=="
}

🗓️ 2025-07-08 ​

✨ 新增 UTR 信息 ​

DANGER

此修改涉及到回调验签，需要我方系统更新后才会有以下UTR的验签信息，故对接完成后，请不要发版使用，确保我方系统更新升级之后，再发版使用最新的回调中UTR参与验签

  • 代收、代付成功回调时新增 UTR 信息
    新的代收回调数据示例：

    json
      {
  "clientId": "2371666556",
  "orderId": "CI123891203982",
  "transactionId": "1234567890",
  "amount": 100.00,
  "paidAmount": 100.00,
  "currency": "INR",
  "status": "SUCCESS",
  "serviceFee": 10.00,
  "payMethod": "101001",
  "payReference":  "xxxx", // UTR, 如有则是具体的UTR，若没有则是空字符串，参与签名
  "sign": "5f4dcc3b5aa765d61d8327deb882cf99"
  }

  • 新的代付回调数据示例:

    json
    {
 "clientId": "2371666556",
 "orderId": "CO123891203982",
 "amount": 100.00,
 "currency": "INR",
 "status": "SUCCESS",
 "serviceFee": 15.00,
 "statusReason": null,
 "payReference":  "xxxx", // UTR, 如有则是具体的UTR，若没有则是空字符串，参与签名
 "sign": "5f4dcc3b5aa765d61d8327deb882cf99"
}

✨ 删除 代收 /payin 接口 ​

目前已全面使用/payin/v1接口替换了原先了 payin接口

DANGER

请检查之前使用的是否是废弃的 /payin 接口，若是，请查看 /payin/v1 接口，并重新对接