Skip to main content

回调外部交易结果通知

基本信息

接口名称:回调外部交易结果通知状  态:已完成
接口路径:POST /api/notifyTradeThird更新时间:2025-05-09 21:12:10
Mock地址:https://apimock.e-buychina.com/mock/713/api/notifyTradeThird

请求参数

Headers:

参数名称参数值是否必填
Content-Typeapplication/json是

Body:

参数名称类型必填默认值备注其他信息
uuidstring是请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
successboolean否交易成功与否 可以不判断 只有支付成功才会有通知Mock:@boolean
actionstring是交易类型最大长度:50
最小长度:1
Mock:notifyTradeThird
timestampnumber是返回时间戳Mock:@timestamp
errorCodestring是错误码最大长度:50
Mock:@word
errorMessagestring是错误描述最大长度:50
Mock:@csentence
signTypestring否签名类型最大长度:20
Mock:sha256
signstring否签名值最大长度:500
Mock:@natural
contentobject是返回报文
  paymentStatusstring否交易记录状态Success成功最大长度:64
最小长度:1
Mock:@string
  eventTypestring是通知事件类型。pay_event支付通知最大长度:20
最小长度:1
Mock:@string
  paymentChannelTypestring是支付渠道最大长度:10
最小长度:1
Mock:@string
  orderIdstring否业务订单 ID最大长度:128
Mock:@string
  totalAmountnumber否订单支付总金额Mock:@natural
  currencystring否币种最大长度:5
Mock:@string
  outTradeNostring是商户请求交易订单号最大长度:50
Mock:@string
  paidAmountstring否支付成功总金额Mock:@string
  cashPaidobject否电子钱包支付金额
    merchantAmountstring是商家实收Mock:@string
    channelTradeNostring是渠道支付订单号(微信
支付宝交易号)
Mock:@string
    userAmountstring是用户实付Mock:@string
    paymentChannelTypestring是支付渠道(微信wechat
支付宝alipay)
Mock:@string
    paidAmountstring是订单金额Mock:@string
    paymentStatusstring是支付状态successMock:@string
    assetTypestring是支付方式cash现金Mock:@string
  userPaidstring否用户支付总金额最大长度:50
Mock:@string
  merchantAmountnumber否商户实收金额Mock:@float(0, 100, 0, 2)
  tradeTimestring否交易发生时间最大长度:25
Mock:@string
  userInfoobject否消费用户信息
    userIdstring是用户idMock:@string
    platformstring是平台标识,枚举Mock:@string
  extendParamsobject否扩展信息,

返回数据

参数名称类型必填默认值备注其他信息

备注

接口地址为三方提供,此处接口地址只做展示使用
通知地址由createTrade时提供 notifyUrl 需要外网能访问的地址做回调

成功返回字符串:SUCCESS,失败返回其他即可
接收到失败后会发起重试,目前重试频率为

15s,15s,30s,3m,10m,20m,30m,30m,30m,60m,3h,3h,3h,6h,6h

重试过程中接收到SUCCESS后 重试即可结束,不再重试了

变更历史

变更日期变更内容
2025-05-09
2025-05-09
2025-03-17
2025-03-17
api-id=37512