1. 收款
Setu
  • Setu API 文档
  • 介绍
  • 签名&代码示例
  • 回调验签
  • 印度
    • 收款
      • 收款回调
      • 收款重定向
      • 创建收款
      • 查询收款状态
      • 发起退款
    • 代付
      • 代付回调
      • 创建代付
      • 查询代付状态
  • 埃及
    • 收款
      • 收款回调
      • 发起退款
        POST
      • 查询收款状态
        POST
      • 创建收款
        POST
    • 代付
      • 代付回调
      • 创建代付
      • 查询代付状态
      • 银行编号
  • 美国
    • 收款
      • 收款回调
      • 创建收款
      • 查询收款状态
      • 发起退款
  • 尼日利亚
    • 收款
      • 收款回调
      • 创建收款
      • 查询收款状态
      • 发起退款
    • 代付
      • 代付回调
      • 创建代付
      • 查询代付状态
      • 银行编号
  • 印度尼西亚
    • 收款
      • 收款回调
      • 发起退款
      • 创建收款
      • 查询收款状态
    • 代付
      • 代付回调
      • 创建代付
      • 查询代付状态
      • 银行编号
  • 账户余额
    POST
  • USDT汇率
    POST
  1. 收款

收款回调

收款回调#

收款订单进入终态后,Setu 向您的地址发送 POST 请求,正文为 JSON。埃及收款以本页字段为准。
回调地址优先使用创建收款时传入的 webhookUrl。未传入时,使用商户后台 Settings 中的收款回调地址。
收到请求后,请先按「回调验签」校验 Signature,再用 transactionRef 调用查询收款状态核对,确认后再更新您的订单。
请返回 HTTP 2xx。Setu 只根据状态码判断是否送达,不检查响应正文。若不是 2xx,Setu 会再次发送。

请求头#

请求头说明
Content-Typeapplication/json
SignatureSetu 私钥签名的标准 Base64
TimestampUnix 时间,单位为秒,参与验签

请求体#

字段说明
transactionRefSetu交易参考号
merchantRef商户参考交易号
amount订单金额
paidAmount订单实付金额(请根据此字段操作账户余额变动)
fee手续费
status订单状态
status 取值:
值说明
Success成功
Timeout超时
Failed失败
Refund退款
Chargeback争议退款

示例#

{
  "transactionRef": "e50f5496-1316-4fa6-a206-98be03550c4d",
  "merchantRef": "19e5b36d-c9d6-4cb4-8e4e-e6fe0e3a0cb5",
  "amount": "100",
  "paidAmount": "100",
  "fee": "5.5",
  "status": "Success"
}
Previous
查询代付状态
Next
发起退款
Built with