子商户入网预下单接口

功能概述

首信易支付子商户入网预下单接口用于平台类商户为平台商品或服务的真实经营者进行开户注册。

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识，商户完成首信易系统注册后可登录商户后 台商户服务查看。 M
requestId 订单号 varchar(50) 订单号为商户自行拟定，提交的订单号 必须在自身平台交易中唯一。商户平台不能以相同的订单号再次提交。 M
registerRole 商户签约性质 固定值 INDIVIDUAL_BUSINESS 个体工商户 M
ENTERPRISE_LEGAL_PERSON 企业法人
NATURAL_PERSON 自然人
被分账方需为自然人
sendActiveE mail 是否发送激 活邮件 固定值 TRUE 是 M
FALSE 否
notifyUrl 入网进展通知地址 varchar(200) 服务器通知：当订单状态发生变更后会向该地址发送五次通知，该地址可以带参数，如: “https://www.5upay.com/callback.action?test=test” M
Name 法人姓名 varchar(50) 法人姓名 M
IdNo 法人身份证 号 varchar(100) 法人身份证 M
PhoneNo 法人手机号 varchar(11) 法人手机号 M
productPacka ge 产品价格套 餐 固定值 GSMA:收单子商户套餐A M
BSBA:被分账方套餐A
hmac 参数签名 varchar(500) 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 M

参数示例

{ "hmac":"P48la7Hbz+nLUT5mcGO3SJayN1CipNECGpgR4TFnHlyzwxj+ytkOE 5jKsKJl4F5HqsQ20PaW7O+WDueCfbd8OALAKAYRwsfazGMVWbEZNo 51nQFEnqKZRbj21mln+5VhGwRSRT1oJCbBGNmALkTs974LbdjeoR/ p4g2Qxdbo4HoMw+l6kUzXAZ66Mxzc1M76cODmZGKEtb0HoeSmdRh/ AKKLRU85KsZywO5GUp+S3DNzQd3Y1NYWHqG2mlVltOPJ1+LXqKmtO FHZ5pDI5hRFHbp8IQgNwEM1mKcJFQGN29ktZl+x5I/nI+aDomCZBL 4YAdVZvqx5T06BkqUEPG7BXQ==", "idNo":"232***3118", "merchantId":"89***7075", "name":"蔡**", "notifyUrl":"http://123qwe.com", "phoneNo":"15****42", "productPackage":"BSBA", "registerRole":"NATURAL_PERSON", "requestId":"12***000", "sendActiveEmail":"TRUE" }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 商户在首信易系统的唯一身份标识，商户完成首信易系统注册后可登录商户后台商户服务查看。
requestId 订单号 订单号为商户自行拟定，提交的订单号必须在自身平台交易中唯一。商户平台不能以相同的订单号再次提交。
status 响应状态 SUCCESS 成功
FAILED 失败
ERROR 错误
signUpUrl 签约链接 h5入网签约链接
errorMessage 错误信息 错误信息
hmac 参数签名 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程

示例

{ "merchantId": "890000593", "requestId": "1527746602492", "subMerchantId": "890000593", "hmac": "959e138ad2e290328e8d59fd124c618f", "status": "SUCCESS" }

异步返回参数列表

参数名称 参数中文名称 参数说明
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 参数签名 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程

示例

{ "hmac":"ts2WSc+ujkkMNMkqsqSbRJFFJt4tEGk/SXCJfbA0PuSRs2RaNOXm2e+cd pMmq5C582BoAVXAmaw11LnyS2Y73oYYiMD4ZIVKD+8cSUo701NOYJPm1j06x5+cO9 y2UqiyF4yAOIJXEtn4LKvBKJ4b6tDfUVsz1rGqsuzFozPsdEJgC9gOJotzBDk8GHf oilCoImhbxRUWwlO9FAMZVigd3O5YA1X+q8Zk/LlKNfPOGLsHULbOdnToASfQjv2S jkF0Ms8/XpjJZSQYZcb0ECrPjVhR4B5/E7AWh1qRlKSkQ7v9cuJFj8GP6iDkNMolI zNXyQHY7yKlmUIrdrTyQ92Oeg==", "merchantId":"890000399", "requestId":"1574340469400", "subMerchantReviewRemarks":"审核不通过", "subMerchantReviewStatus":"NO_PASS", "subMerchantId":"890002222" }