Skip to content

交易结果后台通知

用户支付成功后,根据统一下单接口的异步通知地址,平台将用户支付结果通知商户,商户需要接收处理,并返回应答SUCCESS=Y。

注意

  • 同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。
  • 后台通知交互时,如果平台收到商户的应答不是SUCCESS=Y或超时,平台认为通知失败,并通过一定的策略重新发起通知,会尽可能提高通知的成功率,但不保证通知最终能成功。建议商户也同时接入状态查询接口。
  • 重复通知时间间隔如下:30秒、2分钟、10分钟、30分钟、1小时、2小时、6小时、10小时、15小时。
  • 同步返回:SUCCESS=Y,表示通知成功,否则平台后端会按照通知补发规则重发通知。

业务请求参数

字段名称字段key必填格式备注
应用编号appIdMString(1,40)商户后台创建的应用ID
商户订单号orderNoMString(1,40)
平台订单号transIdMString(1,64)
商户商品名称orderNameMString(1,128)
订单金额orderAmountMNumber(1,22)
交易状态orderStatusMString(1,10)参见 交易状态
支付币种payCurrencyMString(3)参见 货币列表
订单开始时间orderStartTimeMString(14)
订单过期时间orderExpireTimeMString(14)
支付方式payMethodMString(14)支付成功时返回,参见 支付方式
支付成功时间payTimeMString(14)支付成功时返回

通知示例报文

json
{
	"appId": "000110011816681",
    "orderId": "Ea11dB5d-Ae3E-dE93-b21D-B2cA6EdCBC5D",
	"transId": "2401081445566584201",
    "orderName": "test",
    "orderAmount": "1000",
	"orderStatus": "success",
	"payCurrency": "CNY",
    "orderStartTime": "20240108144557",
	"orderExpireTime": "20240108154557"
}

北京腾春科技有限公司