首信易支付子商户入网接口用于平台类商户为平台商品或服务的真实经营者进行开户注册。
https://apis.5upay.com/serviceprovider/declaration/preDeclare
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 服务商自己的商编，在首信易系统的唯一id，可在商户后台查看 | M |
| requestId | 请求号 | varchar(50) | 商户自行拟定，提交的请求号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单，商户平台不能以相同的请求号再次提交 | M |
| notifyUrl | 入网进展通知地址 | varchar(200) | 服务器通知：当入网状态为终态后首信易服务器会向该地址发送通知，该地址可以带参数，如:http://www.5upay.com/callback.action?test=test | M |
| sendActiveEmail | 是否发送激活邮件 | 固定值 | TRUE 是 FALSE 否 不传则默认为“是”, 发激活邮件 |
O |
| productPackage | 产品价格套餐 | 固定值 | MAA：企业账户套餐A | M |
| contactInfo | 联系人信息 | Json | 见下方联系人信息表 | C |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 | M |
| contactName | 联系人姓名 | varchar(50) | 联系人姓名 | C |
| contactEmail | 联系人邮箱 | varchar(100) | 联系人邮箱 | C |
| contactPhone | 联系人手机号 | varchar(11) | 联系人手机号 | C |
注意：以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| requestId | 订单号 | 同请求参数 |
| signUpUrl | 注册链接 | 注册链接 |
| status | 响应状态 | SUCCESS 成功 FAILED 失败 ERROR 错误(此状态的返回参数见异常情况说明) |
| errorMessage | 错误信息 | 错误信息 |
| hmac | 参数签名 | 首信易生成的参数签名结果，验签过程请参考解密流程 |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| 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 | 参数签名 | 首信易生成的参数签名结果，验签过程请参考解密流程 |