进件成功或失败后服务端会通过交易请求上送的returnUrl或后台配置的通知的地址发起form表单提交通知参数（POST方法），服务端通知参数格式和商户请求公共参数一致，且method值统一为CALLBACK,商户收到服务端通知后需返回字符串SUCCESS没有明确返回视为通知失败，进行重试重试频率为3秒，5秒，10秒，15秒，20秒，60秒，2分钟，3分钟，10分钟，10分钟，20分钟，30分钟，30分钟，30分钟，60分钟，3小时，3小时，3小时，如果还通知失败，可调用查询接口查询结果

接口说明

请求URL：https://xxx.com/notify?method=接口说明&version=1.0.0&format=JSON&merchantNo=商户编号&signType=CFCA&signContent=加密内容&sign=签文

请求方式：POST

公共请求参数

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

业务请求参数

变量 参数名 类型[长度限制] 必填 描述
merchantNo 终端商户号 string[1,16] C 慧收钱生成商户编号
storeNo 门店编号 string[1,16] M 慧收钱生成门店编号
transNo 进件请求流水号 string[1,32] R 商户请求进件唯一流水号，每次请求不可重复
status 状态 string[1,16] M 详见附录：状态
applyNo 进件申请编号 string[1,16] C 慧收钱生成进件申请编号
merchantName 商户全称 string[1,32] M 营业执照上的商户名称
merchantShortName 商户简称 string[1,16] M 支付时显示的收单方
platformPublicKey 平台公钥 string[1,2048] C 慧收钱生成的公钥，商户需要存储该信息用于其支付交易
secureKey 签名key string[1,32] C
respCode 应答码 string[1,16] C
respMsg 应答信息 string[1,128] C 应答描述
resultList 进件结果集合 object M JSON集合
参数名 参数描述 类型[长度限制] 必填 备注
seqNo 流水号 string[1,16] M 慧收钱生成报备流水号
businessType 业务类型 string[1,16] M 1：平台商户；2：微信smid；3：支付宝smid
applyStatus 申请状态 string[1,16] M 详见附录：申请状态
channelMerchantNo 业务描述 string[1,128] C 业务类型=1，返回渠道商户号
业务类型=2，返回微信smid
业务类型=3，返回支付宝smid
同类型多数据时用逗号隔开，示例：20888xxxxx,2088xxxxx
respCode 应答码 string[1,16] C
respMsg 应答信息 string[1,128] C 应答描述

公共请求示例

{method=CALLBACK, format=json, signType=CFCA, signContent=7ecbad9cb113bd54e6ee45f7fe76883a40428d548b7294ce8f7ba30f211881073820d3ec7a54d3406dcf7a4d3f87f0994c24db54bab430777425147378dbf01afe0491a1c287e5ce380454b0e228a5a20d541874c14addd4100199660e6c4a857fa080ceb4601a0ee21e3fab9d87016198f151a3b16f60a254c1e8b4cd42cdf7, version=1.0, merchantNo=8000000026}

业务请求示例

业务响应参数

商户收到服务端通知后需返回字符串SUCCESS

业务响应示例

SUCCESS

申请状态码

状态码 描述
AUDIT 审核中
REVIEW 复审中
AUDIT_PASS 审核通过
AUDIT_REFUSE 审核拒绝
CLOSE 销户
STAY 协议待生成
WAIT 待签约
FAILURE 签约失败
SIGNED 已签约

交易状态码

交易状态码 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
FAIL 失败
FINISHED 完成
作者：xiaochen  创建时间：2023-05-24 15:13
最后编辑：xiaochen  更新时间：2024-09-19 18:06