# 回调信息
对接应用在接入前应先将回调信息提交给交易平台的产品人员(见交易平台接入指南),交易平台会在交易完成后, 根据应用方提供的回调地址进行前端及后端回调操作
回调地址分为如下两类:
- 前端通知地址: 支付完成后,浏览器完成页面的重定向,并附带单号、金额等必要的交易参数
- 后端通知地址: 支付完成后,交易平台后端服务会发送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 | 处理失败, 交易平台后续会重复发送通知 |
返回内容的格式为普通的字符串即可
← 签名明文构造规则