# 回调信息

对接应用在接入前应先将回调信息提交给交易平台的产品人员(见交易平台接入指南),交易平台会在交易完成后, 根据应用方提供的回调地址进行前端及后端回调操作

回调地址分为如下两类:

  • 前端通知地址: 支付完成后,浏览器完成页面的重定向,并附带单号、金额等必要的交易参数
  • 后端通知地址: 支付完成后,交易平台后端服务会发送POST请求到接收地址,并附带单号、金额等必要的交易参数,若接收方未能返回成功响应,交易平台会重复发送,重试次数最大为50次

# 验签规则

点击查看

# 通知参数定义

参数名 参数含义 参数类型 是否必填
inputCharset 字符编码, 固定为UTF-8 String
gVersion 服务版本, 固定为1 String
signType 签名算法, 固定为SHA-256 String
appKey 应用Key String
orderId 交易平台的订单ID String
outOrderId 交易平台的外部订单编号 String
payId 交易平台的支付流水ID String
messageType 消息类型, 1: 支付完成, 2: 订单已申请发票, 3: 订单关联的发票已申请作废 4: 订单关联的发票已取消作废申请 Integer
messageContent 消息通知描述, 暂时一般为空 String
payProvider 支付服务商:3为支付宝,4为微信, 21为招商银行 Integer
gSignature 签名 String
extra 自定义参数,下单时提交, 通知时会不变回传 String
crmOrderNum CRM订单编号, 订阅同步CRM业务时存在 String
authOrderNum 授权平台订单编号, 订阅授权平台同步业务时存在 String
notifyTime 通知时间的时间戳, 数值为1970-1-1后经历的毫秒数 Long
payTime 支付时间的时间戳, 数值为1970-1-1后经历的毫秒数 Long

# 通知验签

为了保证交易平台与应用方的通信安全性,交易平台会对发出的通知做签名处理,应用方接到通知后需先做验签操作,验签通过后方可进行后续的业务处理,具体签名规则参考接入指南

# 通知应答

应用方在接收到通知消息时, 应根据处理结果返回相应的应答内容, 告知交易平台是否已成功接收消息通知,若被通知方未能正确的返回应答内容, 交易平台后续 会继续以一定的频率发送通知, 应答格式如下:

应答内容 备注
success 代表应用已成功处理通知, 无需交易平台继续发送
fail 处理失败, 交易平台后续会重复发送通知

返回内容的格式为普通的字符串即可

  • 在线客服

  • 意见反馈