首信易支付子商户入网接口用于平台类商户为平台商品或服务的真实经营者进行开户注册。
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 是 | O |
| FALSE 否 | ||||
| 不传则默认为“是”, 发激活邮件 | ||||
| productPackage | 产品价格套餐 | 固定值 | 该参数值可咨询商务经理 | M |
| registerRole | 商户签约性质 | 固定值 | INDIVIDUAL_BUSINESS 个体工商户 | O |
| ENTERPRISE_LEGAL_PERSON 企业法人 | ||||
| NATURAL_PERSON 自然人 | ||||
| 可以限制签约性质，也可以让商户自己选择签约性质 | ||||
| contactInfo | 联系人信息 | Json | 见下方联系人信息表 | C |
| paymentProfiles | 产品支付方式 | Json | 见产品支付方式表 | O |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 | M |
| contactName | 联系人姓名 | varchar(50) | 联系人姓名 | C |
| contactEmail | 联系人邮箱 | varchar(100) | 联系人邮箱 | C |
| contactPhone | 联系人手机号 | varchar(11) | 联系人手机号 | C |
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| paymentMode | 支付方式 | 固定值 | B2C 个人网银 | C |
| B2B 企业网银 | ||||
| EXPRESS_PAY_ISNOTDIRECT_DEBIT 快捷支付标准版借记卡 | ||||
| EXPRESS_PAY_ISNOTDIRECT_CREDIT 快捷支付标准版贷记卡 | ||||
| EXPRESS_PAY_ISDIRECT_DEBIT 快捷支付专业版借记卡 | ||||
| EXPRESS_PAY_ISDIRECT_CREDIT 快捷支付专业版_贷记卡 | ||||
| WEIXIN_OFFICIAL 微信公众号 | ||||
| WEIXIN_MINIAPPS 微信小程序 | ||||
| ALIPAY_WAP 支付宝wap | ||||
| ALIPAY_OFFICIAL 支付宝生活号 | ||||
| WEIXIN_EQRCODE 易码付-微信 | ||||
| ALIPAY_EQRCODE 易码付-支付宝 | ||||
| WEBOX_EQRCODE_DEBIT 易码付-微包-借记卡 | ||||
| WEBOX_EQRCODE_CREDIT 易码付-微包-贷记卡 | ||||
| WEBOX_EQRCODE_BALANCE 易码付-微包-余额 | ||||
| UNION_EQRCODE 易码付-云闪付 | ||||
| WEBOX_APP_DEBIT 微包APP-借记卡 | ||||
| WEBOX_APP_CREDIT 微包APP-贷记卡 | ||||
| WEBOX_APP_BALANCE 微包APP-余额 | ||||
| WEBOX_SVC_DEBIT 微包服务号-借记卡 | ||||
| WEBOX_SVC_CREDIT 微包服务号-贷记卡 | ||||
| WEBOX_SVC_BALANCE 微包服务号-余额 | ||||
| UNION_SCANCODE_PAY 银联扫码支付 | ||||
| APP_UNION 云闪付收银台支付 | ||||
| MINIAPPS_ALI_PAY 支付宝小程序支付 | ||||
| UNION_WAP 银联WAP支付 | ||||
| 商户入网类型为收单子商户时可传 | ||||
| feeType | 费率类型 | 固定值 | SINGLE 单笔 | C |
| RATE 百分比 | ||||
| 商户入网类型为收单子商户时可传(需与服务商类型保持一致) | ||||
| feeAmount | 费率 | varchar(10) | 商户入网类型为收单子商户时，费率可传自定义费率，若计费种类为百分比时，可以支持填写到小数点后四位（一般需大于服务商费率）如不传则按服务商默认费率 | 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 | 参数签名 | 首信易生成的参数签名结果，验签过程请参考解密流程 |