商户入网结果通知

接口描述

商户状态变更时会将变更结果通知给接入方，触发该通知的情况有如下几种：
商户入网状态变更
商户审核状态变更
商户签约状态变更
商户信息修改变更

注意事项

同样的通知可能会多次发送给接入方系统。接入方系统必须能够正确处理重复的通知。
接入方系统对于开启结果通知的内容一定要做签名验证，并校验通知的信息的正确性，防止数据泄露导致出现“假通知”，造成损失。
当接入方系统收到甬易的推送通知时，必须输出 SUCCESS ，甬易收到 SUCCESS ，便认为接入方已收到；否则将继续发送通知，以递增的时间间隔再次重发 5 次；时间间隔分别为 24s,1m,1m,6m,12m。

请求方式

POST

通知参数

参数名	必选	类型	最大长度	说明	示例
code	是	string		响应编码	00000000
message	是	string		响应信息	成功
signature	是	string		签名
transNonce	是	string	32	请求流水号	123456
transDate	是	string	13	请求时间，13位时间戳	1731406784607
requestNo	是	string	32	接入方请求流水号(作入网结果通知时同outMerchantNo)	123456789
merchantNo	是	string	32	商户编号	XS241113000204
notifyType	是	string	64	通知类型	merchant_audit_notify-商户审核结果通知；merchant_apply_notify-商户入网结果通知；merchant_esign_notify-商户电子签约结果通知；merchant_base_modify_notify-商户基础信息变更通知；merchant_fee_modify_notify-商户费用变更通知
applyStatus	是	string		商户状态： INIT-初始，PROCESSING-处理中，SUCCESS-入网成功，FAIL-入网失败	SUCCESS
applyReason	是	string	255	入网失败原因
auditStatus	是	string		审核状态 WAIT-待审核，REFUSE-审核拒绝，PASS-审核通过	SUCCESS
auditReason	是	string	255	审核拒绝原因
esignStatus	是	string		签约状态 AUTH_PROCESS-待授信，AUTH_PROCESSING-授信中，AUTH_SUCCESS-授信成功，AUTH_FAIL-授信失败，ESIGN_PROCESS-待签约，ESIGN_PROCESSING-签约中，ESIGN_SUCCESS-签约成功，ESIGN_FAIL-签约失败	ESIGN_PROCESS
esignReason	是	string	255	签约失败原因
esignUrl	否	string	500	电子签约链接
esignContractUrl	否	string	500	合同文件下载地址,入网成功签约成功时返回
esignContractName	否	string	100	合同文件名称,入网成功签约成功时返回
payAuthCorpoAccountName	否	string	100	对公认证打款公司账户名称，需企业认证时返回
payAuthCorpoAccountNo	否	string	100	对公认证打款公司账户号，需企业认证时返回
payAuthCollectAccountName	否	string	100	对公认证打款收款账户名称，需企业认证时返回
payAuthCollectAccountNo	否	string	100	对公认证打款收款账户号，需企业认证时返回
payAuthCollectCompanyName	否	string	100	对公认证打款收款公司名称，需企业认证时返回
payAuthAmount	否	string	100	对公认证打款金额，需企业认证时返回
payAuthRemark	否	string	100	对公认证打款备注，需企业认证时返回

通知报文示例

json

 {
  "applyReason": "成功",
  "applyStatus": "SUCCESS",
  "auditReason": "审核通过",
  "auditStatus": "PASS",
  "code": "00000000",
  "esignReason": "待签约",
  "esignStatus": "ESIGN_PROCESS",
  "esignUrl": "https://dev-cdn.yoyipay.com/yoyipay-app/htmlPdf/index.html?appId=202408554212370909&merchantId=XS241113000206&signFileId=PRI9f1da800b2634e45a17e170c07e9b53a.pdf&timestamp=1731486024118&signData=8afa94c97e9524522b2fa9264516375e158600adb2f9df1def6632ddcfb6b94f",
  "notifyType":"merchant_apply_notify",
  "merchantNo": "XS241113000206",
  "message": "成功",
  "requestNo": "ZD2411131548313",
  "signature": "SaS/fodXKP3D6oOnDFT/tp8MHmhQlQ0eg5AKStgRQyVlNnbfzpuZr59xtiPIXGoaBcc5xVE/bhmnnEWx/e5M9qdHzjVUeoW9viPs6NGMUkntFhTn9CI6qR5aO1NAKIKZwpP3XkSkZxCK8+ojam2fNAVQkQFPTjO6jq40O7j9/ULc9QruoEgo+8SODbJLd1bY7tQ74kwogZOBZdoizNkiGqnOkGmKLOx5egkBHZ0rW9MX1AjV1VRqim01Q3q5oDbJjcO0MzAGQ8BiABYXDJ4Nr9NoM8yBD155S3kM/pyxjx+L1FTPUVNqtb6plPh5X5ua8TeBNIXbbSAYGQpK4AMrPQ==",
  "transNonce": "4e4b8ce67a964e77a9c143e4d4867364"
}

响应报文

 SUCCESS

商户入网结果通知 ​

接口描述 ​

注意事项 ​

请求方式 ​

通知参数 ​

通知报文示例 ​

响应报文 ​

商户入网结果通知

接口描述

注意事项

请求方式

通知参数

通知报文示例

响应报文