法币付款通知 · YHT

XPay 商户接口 · 2026-11-09 更新 · 金额单位：人民币元

付款结果由 XPay 发送至下单时填写的 notifyUrl。这是 XPay 发给商户的业务通知。

POST 商户 notifyUrl
Content-Type: application/x-www-form-urlencoded
当前通知是表单字段，不是 JSON；接收后返回 HTTP 2xx，可使用正文 OK。平台当前只判断 HTTP 状态码。
实际通知字段示例
{
  "platformOrderNo": "YHT20261109000000DEMO01",
  "merchantOrderNo": "WEB-20261109-0001",
  "status": 2,
  "amount": "0.01",
  "payTime": 1794205651
}
字段说明
platformOrderNo平台订单号
merchantOrderNo商户订单号
status本地订单状态；2 表示付款成功
amount人民币元
payTimeUnix 秒级付款时间戳
当前通知不含 sign / signature，也不含 attach。
收到通知后，由商户服务器使用自己的 AppID / APPSECRET 调用签名查单接口，核对订单号、金额和 status=2，再完成发货或入账。不要直接把未签名的通知当作到账凭证。

处理流程

  1. 接收表单，核对订单属于本商户业务。
  2. 通过签名查单确认金额、订单身份和付款状态。
  3. 按 merchantOrderNo 幂等入账，重复通知不能重复发货。
  4. 返回 HTTP 2xx；并为未完成订单设置后台查单补偿。

当前通知转发不提供持久重试保证，不能依赖通知必达；请保留查单补偿。浏览器跳转 redirectUrl、客户端提示成功都不能替代服务端状态确认。

状态值

值含义
1待支付
2已支付
3已关闭 / 支付失败 / 超时关闭
4已全额退款
5已部分退款

查看签名查单接口