4.7交易结果通知


注意:因为以后可能会增加通知参数,请获取全量变量,然后遍历获取非空变量,而不能用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  
fqnum String 分期数 16  

备注:chnldata字段内容

序号 数据元中文名 标识 类型 取值说明
1 总营销优惠金额 discountAmt String(1..12) 仅支持数字,返回营销活动的总优惠金额,原交易参与营销时返回
2 商户出资优惠金额 merDiscountAmt String(1..16) 仅支持数字,代表商户出资优惠金额,在商户出资场景下返回,与本金一起轧查清算
3 营销活动ID discountId String(1..40) 票券编号、活动编号等,格式自定义
4 营销活动名称 activityNm String(1..60) 优惠活动简称,可用于消费展示,订单打印等

yinjr 2025年4月24日 13:53 收藏文档