实时提现交易(一般户到银行卡)异步通知
1、修订记录
| 修订记录 |
日期 |
说明 |
| 1.0 |
2024.03.29 |
初版 |
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数据明文字符串）
| 参数 |
类型(长度） |
必填 |
参数说明 |
| state |
String |
N |
交易状态，成功：00；失败：99；退票成功：01 |
| msg |
String |
N |
状态描述 |
| orderId |
String |
N |
商户订单号,同请求报文“商户订单号”
|
| tradeSn |
String |
N |
交易流水号,银盛内部订单号
|
| shopDate |
String |
N |
交易日期，格式：yyyyMMdd
|
| accountDate |
String |
N |
会计日期,格式：yyyyMMdd
|
| amount |
String |
N |
订单金额,单位:分
|
| fee |
String |
N |
手续费,单位:分
|
| payeeFee |
String |
N |
收款方手续费,单位:分
|
| partnerFee |
String |
N |
合作方手续费,单位:分
|
| payerFee |
String |
N |
付款方手续费,单位:分
|
| payeeFeeFlag |
String |
N |
收款方手续费标志
|
| partnerFeeFlag |
String |
N |
合作方手续费标志
|
| payerFeeFlag |
String |
N |
付款方手续费标志
|
| isDiscountFlag |
String |
N |
是否参与营销 1:参与 其他:不参与
|
| payeeFeeDiscount |
String |
N |
收款方营销后的手续费
|
| partnerFeeDiscount |
String |
N |
合作方营销后的手续费
|
| payerFeeDiscount |
String |
N |
付款方营销后的手续费
|
| partnerMercId |
String |
N |
合作方商户号，同请求报文certId |
| notifyTime |
String |
N |
通知发起日期，格式:yyyyMMddHHmmss
|
| tradeType |
String |
N |
固定值： 321
|
4、接入方返回值定义
接入方返回参数为String，不返回和非success都为失败，如果接入方处理失败，可以返回处理失败原因，以供查找问题