4.5交易结果通知


注意:因为以后可能会增加通知参数,请获取全量变量,然后遍历获取非空变量,而不能用request.getparam(“key”)这样用文档中的字段名来一个个获取,到时候收银宝增加通知字段,就无法兼容了.请参考demo

通知的每一个字段都会进行UTF-8的UrlEncode,如果商户接收结果的服务器用web容器进行接收,例如TOMCAT,IIS.则无需进行URLDecode,如果不是用web容器进行接收,而是读数据流自己进行解析,则需要进行UTF-8的UrlDecode

以java为例:
String trxreserve = "订购人+10086";
String sendData = URLEncoder.encode(trxreserve, "UTF-8");
String getData = URLDecoder.decode(sendData, "UTF-8");

通知响应结果:
商户服务端在接收到结果通知并正确处理后,应响应消息。正确处理响应success,其他响应或者不响应通联开发平台则通过重发机制进行重发,重发次数为5次

对后台通知交互时,如果通联收到商户的应答不符合规范或超时,通联认为通知失败,通联会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但通联不保证通知最终能成功。

(通知频率为15s/15s/5m/10m/15m - 总计30m30s)


请求参数:

字段名称 类型 可空 说明 最长长度 备注
appid string 收银宝APPID 8  
outtrxid string 第三方交易号 50 暂未启用
trxcode string 交易类型 8 详见附录交易类型
trxid string 收银宝交易单号 50 通联收银宝交易流水号
initamt string 原始下单金额 20 与请求trxamt值一致
trxamt long 交易金额 20 单位:分
trxdate string 交易请求日期 8 yyyymmdd
paytime string 交易完成时间 14 yyyymmddhhmmss
chnltrxid string 渠道流水号 64 如支付宝,微信平台订单号
trxstatus string 交易结果码 4 交易状态详见交易返回码说明
cusid string 商户编号 15  
termno string 终端编号 20  
termbatchid string 终端批次号 16  
termtraceno string 终端流水号 6  
termauthno string 终端授权码 20  
termrefnum string 终端参考号 50  
trxreserved String 业务关联内容 160 交易备注
srctrxid string 原交易流水 50 通联原交易流水,冲正撤销交易本字段不为空
cusorderid string 业务流水 32 统一下单对应的reqsn订单号
acct string 交易账号 64

如果是刷卡交易,则是隐藏的卡号,例如

621700******4586

fee string 手续费 15 单位:分
signtype string 签名类型 3 MD5/RSA/SM2。为空默认MD5
cmid string 渠道子商户号 32 仅微信/支付宝交易有效
chnlid string 渠道号 32 仅微信交易有效
chnldata String 渠道信息 - 仅返回云闪付/微信/支付宝的渠道信息
accttype String 借贷标识 2

00-借记卡

02-信用卡

99-其他(花呗/余额等)

bankcode String 发卡行 20  
logonid String 支付宝买家账号 32  
sign String sign校验码 32  

备注:chnldata
云闪付示例:{"couponInfo":"[{"id":"2112020052715193","desc":"2020年银联62节-永旺超市蒙牛百利包单品营","type":"CP01","spnsrId":"00010000","offstAmt":"1100"},{"id":"2112020052715193","desc":"2020年银联62节-永旺超市蒙牛百利包单品营","type":"CP01","spnsrId":"82119105411XXXX","offstAmt":"900"}]"}
支付宝示例:{"voucher_detail_list":"[{"amount":"0.20","merchantContribute":"0.20","name":"0.20元代金券","otherContribute":"0.00","type":"ALIPAY_BIZ_VOUCHER","voucherId":"2020060400073002293805XTTADO"}]","fund_bill_list":"[{"amount":"0.80","fundChannel":"ALIPAYACCOUNT"},{"amount":"0.20","fundChannel":"MDISCOUNT"}]"}
微信示例: {"promotion_detail":"[{"amount":100,"merchant_contribute":"100","other_contribute":"0","promotion_id":"11605335223","type":"DISCOUNT","wxpay_contribute":"0","scope":"GLOBAL","activity_id":"10722272","name":"返回优惠信息券"}]"}


yinjr 2024年8月1日 17:35 收藏文档