凭据交易通知

接入方企业申请的凭据在完成消费等场景后,慧收钱主动向企业发送本交易,向其同步凭据交易信息(本交易仅供企业作为信息展示使用)。


接口说明

  • 通知地址:商户后台通知地址。
  • 请求方式:POST

业务流程:

  1. 慧收钱平台通知受理侧企业凭据交易结果。
  2. 受理侧企业应答返回HTTP状态码200。

通知规则

  • 商户收到服务端通知后需返回字符串SUCCESS,如果未收到应答或未按要求返回,则视为通知失败。

公共通知参数

变量 参数名 类型[长度限制] 必填 描述
method 方法名 string[1,32] CALLBACK_BILL_TRADE
version 版本 string[1,16] 接口版本:1.0
format 请求格式 string[1,16] 业务请求参数格式,支持:JSON
merchantNo 商户号 string[1,16] 商户在慧收钱的商户号,由慧收钱生成并下发
signType 加密类型 string[1,16] RSA2:签名机制查看说明
signContent 业务数据 string 业务请求参数
sign 签名数据 string[1,256] 签名数据

业务参数

变量 参数名 类型[长度限制] 必填 描述
txnDate 交易日期 string[1,8] 银联返回
txnNo 交易流水号 string[1,64] 银联返回
sndTime 发送时间 string[1,6] 银联返回,格式:hhmmss
merId 商户代码 string[1,50] token受理商户代码
merName 商户名称 string[1,60] token受理商户名称
orderNo 商户订单号 string[1,40] 银联返回
transTime 交易时间 datetime 格式: yyyyMMddHHmmss
txnAmt 交易金额 string[1,16] 单位:分
disAmt 优惠后金额 string[1,16] 单位:分
currencyCode 币种 string[1,5] CNY
transId 交易编码 string[1,64] pay.account.consume(消费)
pay.account.cancel(撤销&冲正)
pay.account.transResultNotify(退货)
transMd 交易方式 string[1,2] 01:前台网关支付
02:Wap支付
03:控件支付
04:无跳转支付
05:二维码被扫
06:二维码主扫
99:其他暂未定义
procSt 交易处理状态 string[1,32] 81:成功
80:失败
80:处理中
trId TRID string[1,11] 银联返回
billTokenId 凭据标记 string[1,19] -
transIdx 交易索引号 string[1,27] 银联返回
transDtTm 交易传输时间 string[1,10] 格式 :MMDDhhmmss
sysTraNo 系统跟踪号 string[1,6] 银联返回
respCd 交易应答码 string[1,2] 根据该状态判断token交易是否成功,00表示成功,非00表示失败
00: 承兑或交易成功
01: 查发卡方
03: 无效商户
05: 身份认证失败
12: 无效的关联交易
13: 无效金额
14: 无卡号( 无此账号)
15: 无此发卡方
22: 故障怀疑,关联交易错误
25: 找不到原始交易
30: 报文格式错误
51: 资金不足
54: 过期的卡
61: 超出金额限制
64: 原始金额错误
orgTransIdx 原交易索引号 string[1,27] 银联返回
orgOrderNo 原商户订单号 string[1,40]
orgTransDtTm 原交易传输时间 string[1,10] 格式: MMDDhhmmss
orgTransTime 原交易时间 string[1,14] 格式: yyyyMMddHHmmss
orgSysTraNo 原系统跟踪号 string[1,6] 银联返回
termId 终端号 string[1,8] 银联返回
merCatCode 商户类别 string[1,4] 商户在银联系统进件时归属的商户类别