单笔代付异步通知
1、修订记录
| 修订记录 | 日期 | 说明 |
|---|---|---|
| 1.0 | 2023.12.18 | 初版 |
2、业务说明
2.1、接口说明
银盛支付对商户的请求数据处理完成后，会将处理的结果数据通过服务器主动通知的方式通知给商户网站。这些处理结果数据就是服务器异步通知参数。注意：
1、接入方接受异步通知结果后，返回success表示该次异步通知成功，银盛将会按成功处理该次异步通知。
2、接入方接收到异步通知后，同步返回非success，银盛认为该次异步通知失败了，银盛将会再通知5次，间隔频率分别为1分钟、5分钟、10分钟、30分钟、60分钟共5次通知。凡是其中一次返回success银盛将会终止通知。
3、同样的通知可能会多次发送给接入方（例如调用接入方超时，接入方返回失败等）。
2.2、接入方接受异步通知接口的要求：
1、接受方式：POST
2、接受主体类型：application/json
3、需要对通知的数据进行验签，验签使用公钥验签，详见demo
4、必须要有一个返回值 该值为String类型。
5、接入方必须能够正确处理重复的通知，以避免函数重入造成的数据混乱。
3、异步通知报文结构
3.1、公共请求参数
| 参数 | 类型(长度） | 必填 | 参数说明 |
|---|---|---|---|
| timeStamp | String | Y | 发送请求的时间，格式"yyyy-MM-dd HH:mm:ss" |
| src | String | Y | 异步通知来源，固定"pregate" |
| reqId | String | Y | 请求流水号 |
| charset | String(10) | Y | 编码格式 固定为UTF-8 |
| sign | String | Y | 签名，需要银盛公钥验签,详见demo |
| bizContent | String | Y | 业务响应数据 json字符串 |
3.2、业务请求参数
（bizContent加密前的json数据明文字符串）| 参数 | 类型(长度） | 必填 | 参数说明 |
|---|---|---|---|
| orderId | String | Y | 订单号 |
| state | String | Y | 交易状态: 00 代付成功 01 退票成功 99 代付失败 |
| msg | String | Y | 交易描述 |
| notifyTime | String | Y | 发送请求的时间: 格式"yyyyMMddHHmmss" |
| tradeType | String | Y | 交易类型备注: 102:实时代付;112:代付单转批;321:实时提现;328:D0提现; |
| amount | Number | Y | 代付的总金额。单位为：RMB Yuan。取值范围为[0.01，99999999.99]，精确到小数点后两位 |
| accountDate | String | Y | 会计日期: 格式为yyyyMMdd |
| shopDate | String | Y | 商户日期: 格式为yyyyMMdd |
| tradeSn | String | Y | 交易流水 |
| payerFee | Number | N | 付款方手续费,单位:元 |
| payeeFee | Number | N | 收款方手续费,单位:元 |
| partnerFee | Number | N | 合作方手续费,单位:元 |
| payerFeeFlag | String | N | 付款方手续费类型, 01：实时结算未统计 11：实时结算已统计 02：日结算，未统计 12：日结算，已统计 03：月结算，未统计 13：月结算，已统计 50：尚未计费初始值 批量业务使用,订单初始化使用 |
| payeeFeeFlag | String | N | 收款方手续费类型, 01：实时结算未统计 11：实时结算已统计 02：日结算，未统计 12：日结算，已统计 03：月结算，未统计 13：月结算，已统计 50：尚未计费初始值 批量业务使用,订单初始化使用 |
| partnerFeeFlag | String | N | 合作方手续费类型, 01：实时结算未统计 11：实时结算已统计 02：日结算，未统计 12：日结算，已统计 03：月结算，未统计 13：月结算，已统计 50：尚未计费初始值 批量业务使用,订单初始化使用 |
| fee | Number | N | 订单总手续费: 单位：元 |
| isDiscountFlag | String | N | 是否参与营销: 1:参与 其他:不参与 |
| payeeFeeDiscount | Number | N | 收款方营销后的手续费, 单位:元 |
| payerFeeDiscount | Number | N | 付款方营销后的手续费, 单位:元 |
| srcFeeDiscount | Number | N | 发起方营销后的手续费, 单位:元 |
| srcMercId | String | N | 发起方商户号 |
| tradeSource | String | N | 交易来源 |
4、接入方返回值定义
接入方返回参数为String，不返回和非success都为失败，如果接入方处理失败，可以返回处理失败原因，以供查找问题| 返回值 | 说明 |
|---|---|
| success | 成功 |