如何对接 UPI 代付 API

对接一个 UPI 代付 API 并不复杂。本文走一遍典型步骤,并给出示例请求,让你的团队心里有数。

第 1 步 —— 拿到凭证

开通后你会拿到商户 ID 与密钥。代付请求用 MD5 签名鉴权(由订单号、时间戳与密钥生成)。

第 2 步 —— 加白你的服务器 IP

代付接口只接受你授权的服务器 IP 的请求 —— 给出款多一层保护。

第 3 步 —— 发起代付

POST 收款人信息与金额:

# 发起一笔代付
POST https://api.xpay24.net/v1/payouts/create
{
  "merchantId": 1001,
  "orderId":    "PO20260724001",
  "amount":     50000,
  "payoutType": "UPI",
  "accountNumber": "name@bank",
  "timestamp":  1784540680182,
  "sign":       "md5(orderId+timestamp+密钥)"
}

第 4 步 —— 处理回调

XPay 会回调你的 notifyUrl,带最终状态与 UTR。校验签名、更新记录、返回 OK。若你的接口没确认,XPay 会自动重试。

就这四步,你就能以编程方式发放 UPI 与 IMPS 代付。完整字段见我们的文档。