收款回调

收款订单进入终态后，Setu 向您的地址发送 POST 请求，正文为 JSON。印度收款以本页字段为准。

回调地址优先使用创建收款时传入的 webhookUrl。未传入时，使用商户后台 Settings 中的收款回调地址。

收到请求后，请先按「回调验签」校验 Signature，再用 transactionRef 调用查询收款状态核对，确认后再更新您的订单。

请返回 HTTP 2xx。Setu 只根据状态码判断是否送达，不检查响应正文。若不是 2xx，Setu 会再次发送。

请求头

请求头	说明
Content-Type	application/json
Signature	Setu 私钥签名的标准 Base64
Timestamp	Unix 时间，单位为秒，参与验签

请求体

字段	说明
transactionRef	Setu交易参考号
merchantRef	商户参考交易号
currency	印度货币单位
method	收款方式。取值：NATIVE、COMPANY、PERSONAL
amount	订单金额
paidAmount	订单实付金额(请根据此字段操作账户余额变动)
fee	手续费
status	订单状态
utr	—
payerVPA	付款人账号
payerName	付款人名字

status 取值：

值	说明
Success	成功
Timeout	超时
Failed	失败
Refund	退款
Chargeback	争议退款

示例

{
  "transactionRef": "e50f5496-1316-4fa6-a206-98be03550c4d",
  "merchantRef": "19e5b36d-c9d6-4cb4-8e4e-e6fe0e3a0cb5",
  "currency": "INR",
  "method": "NATIVE",
  "amount": "100.01",
  "paidAmount": "100.01",
  "fee": "5.5",
  "status": "Success",
  "utr": "101651278613",
  "payerVPA": "example@upi",
  "payerName": "name"
}

收款回调

收款回调#

请求头#

请求体#

示例#

收款回调

请求头

请求体

示例