凭据交易通知
接入方企业申请的凭据在完成消费等场景后,慧收钱主动向企业发送本交易,向其同步凭据交易信息(本交易仅供企业作为信息展示使用)。
接口说明
- 通知地址:商户后台通知地址。
- 请求方式:POST
业务流程:
- 慧收钱平台通知受理侧企业凭据交易结果。
- 受理侧企业应答返回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] | 否 | 商户在银联系统进件时归属的商户类别 |