商户入网查询

功能概述

商户通过子商户入网查询接口查询首信易支付平台的子商户入网状态。

接口地址

https://apis.5upay.com/serviceprovider/declaration/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
requestId 请求号 varchar(50) 子商户入网接口传入的requestid C
subMerchantId 子商户编号 varchar(9) 由首信易创建的子商户编号(和订单号二选一传递)。 C
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "890000593", "subMerchantId": "890000593", "hmac": null }

入网查询返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 成功
ERROR 错误(此状态的返回参数见异常情况说明)
errorMessage 错误信息 错误信息
merchantId 商户编号 同请求参数
requestId 入网请求号 同请求参数
subMerchantReviewStatus 子商户审核状态 PROCESSING 审核中(ocr校验失败时返回该状态,子商户审核备注信息中可查看详情)
PASS 审核通过
NO_PASS 审核不通过
REFUSE 审核拒绝
ESIGN_PROCESS 待签约
ESIGN_PROCESSING 签约中
ESIGN_FAIL 签约失败(电子签签约状态)
ESIGN_SUCCESS 签约成功(电子签签约状态)
SUCCESS 入网完成
subMerchantReviewRemarks 子商户审核备注信息 审核意见
subMerchantId 子商户编号 同请求参数
electronicContractingUrl 电子签约链接 若签约方式为电子签约(自定义签约),则在子商户审核状态为“ESIGN_PROCESSING 签约中”时返回电子签约地址。
postReviewStatus 核查状态 INIT 初始化
SUCCESS 核查通过
FAIL 核查不通过
COMPLEMENT 核查补充
返回“核查补充”状态时,可通过“核查补充”接口或核查补充链接提交补充的材料,当触发入网后核查时, 会返回“核查状态”,核查不通过将影响交易
certificateSupplementUrl 核查补充链接 当postReviewStatus“核查状态”为COMPLEMENT“核查补充”时,返回核查补充链接,入网商户可以通过该链接对需要补充的资质进行上传
postReviewRemark 核查备注 核查状态为“核查不通过“或“核查补充”时,返回该字段
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "merchantId":"896666813", "subMerchantId":"899015841", "requestId":"16898383516099997", "subMerchantReviewStatus":"ESIGN_PROCESS", "subMerchantReviewRemarks": "审核通过", "status":"SUCCESS" "electronicContractingUrl":"https://merchant.5upay.com/signcontract.html?key=8a89806989d89d3038efe0005", "postReviewStatus":"COMPLEMENT", "certificateSupplementUrl":"https://merchant.5upay.com/joinh5/infoSupplement?code=ang0ZWhzWYwMDAz", "postReviewRemark":"测试(需要补充的材料名称:店内场景照片,门店门头照片)", "hmac":"auCRFQ5889zG8D0kSmzM47lCjz7Xa98k85W2C7rNfjKzi/2Arb4hTd/oUMVsodbex1xUc6Se988w==", }