老板管账特约商户入网(企业/个体)-收单+结算

请求参数

Header 参数

x-yop-sdk-version

string

可选

默认值:

4.0.0

Body 参数application/x-www-form-urlencoded

requestNo

string

必需

入网请求号

<= 64 字符

示例值:

YBRWQQH20231113XXXXXX

businessRole

string

入网商户业务角色

必需

ORDINARY_MERCHANT:标准商户
PLATFORM_MERCHANT:平台商
SETTLED_MERCHANT:入驻商户

a. 标准商户：
1、SAAS服务商拓展的收单商户，无上下游或者相关业务方；2、目前仅支持事业单位/社会团体/企业/个体工商户的签约类型商户；
b. 平台商：
1、经营线上或者线下交易撮合平台，可入驻上下游；2、目前仅支持事业单位/社会团体/企业的签约类型商户；
c. 入驻商户：
1、只能入驻到特定平台商的下级；2、目前仅支持事业单位/社会团体/企业/个体工商户的签约类型商户；

示例值:

ORDINARY_MERCHANT

parentMerchantNo

string

父级商户编号

必需

SAAS服务商-标准商户；SAAS服务商-平台商-入驻商户。如果该入网商户是标准商户或者平台商，则需要上送已入网完成的SAAS服务商编号；如果该入网商户是入驻商户，则需要上送对应平台商的商户编号。

<= 32 字符

notifyUrl

string <notify-url>

必需

商户回调地址

<= 256 字符

示例值:

https://notify.merchant.com/xxx

merchantSubjectInfo

string

商户主体信息

必需

见商户主体信息

示例值:

{ "licenceUrl":"商户证件照片地址", "signName":"商户签约名", "signType":"商户签约类型", "licenceNo":"商户证件号码", "shortName":"商户简称" }

merchantCorporationInfo

string

商户法人信息

必需

见商户法人信息

示例值:

{ "legalName":"法人名称", "legalLicenceType":"法人证件类型", "legalLicenceNo":"法人证件编号", "legalLicenceFrontUrl":"法人证件正面照片地址", "legalLicenceBackUrl":"法人证件背面照片地址" }

merchantContactInfo

string

商户联系人信息

必需

见老板管账商户联系人信息

示例值:

{ "contactName":"联系人姓名", "contactMobile":"联系人手机号", "contactEmail":"联系人邮箱", "contactLicenceNo":"联系人证件号码"}

settlementAccountInfo

string

结算账户信息

必需

见结算账户信息

示例值:

{ "settlementDirection":"结算方向", "bankCode":"开户总行编码", "bankAccountType":"银行账户类型", "bankCardNo":"银行账户号码" }

industryCategoryInfo

string

行业分类

可选

见行业分类

示例值:

{ "primaryIndustryCategory":"一级行业分类编码", "secondaryIndustryCategory":"二级行业分类编码" }

businessAddressInfo

string

经营地址

必需

见经营地址

示例值:

{ "province":"经营省编码", "city":"经营市编码", "district":"经营区编码", "address":"经营地址" }

productInfo

string

开通产品

必需

见老板管账开通产品信息

示例值:

[{"rateType":"SINGLE_FIXED","productCode":"D1","fixedRate":"0","paymentMethod":"REAL_TIME","undertaker":"PLATFORM_MERCHANT"},{"rateType":"SINGLE_PERCENT","productCode":"USER_SCAN_WECHAT_OFFLINE","fixedRate":"1","paymentMethod":"REAL_TIME","percentRate":"11","undertaker":"PLATFORM_MERCHANT"},{"rateType":"SINGLE_PERCENT","productCode":"MERCHANT_SCAN_WECHAT_OFFLINE","fixedRate":"1","paymentMethod":"REAL_TIME","percentRate":"1","undertaker":"PLATFORM_MERCHANT"},{"rateType":"SINGLE_PERCENT","productCode":"WECHAT_OFFIACCOUNT_WECHAT_OFFLINE","fixedRate":"1","paymentMethod":"REAL_TIME","percentRate":"1","undertaker":"PLATFORM_MERCHANT"},{"rateType":"SINGLE_PERCENT","productCode":"USER_SCAN_ALIPAY_OFFLINE","paymentMethod":"REAL_TIME","minRate":"1","percentRate":"1","undertaker":"PLATFORM_MERCHANT"}]

productQualificationInfo

string

产品资质

可选

见产品资质信息

1.开通POS产品必填 mcc；
2.开通企业付款-实时/两小时/次日必传付款场景，为了增加商户审核通过率，建议传付款业务协议图片/附件与付款业务系统截图/附件；如为特殊申请也需上传特批开通流程/截图

示例值:

{ "paymentScene": "RLZYFW", "systemScreenshotUrl": "https://staticres.yeepay.com/xxx.文件后缀", "specialPermitProcessUrl": "https://staticres.yeepay.com/xxx.文件后缀", "agreementPhotoUrl": "https://staticres.yeepay.com/xxx.文件后缀" }

functionService

string

功能服务

可选

见功能服务信息

示例值:

["BACKUP","SHARE"]

functionServiceQualificationInfo

string

功能服务配套资质信息

可选

见服务资质信息

示例值:

{"shareScene":"FZ_FJ001","shareCertificate":"https://staticres.yeepay.com/xxx.文件后缀","alipayBackupCount":"5","wechatBackupCount":"30"}

sellerNo

string

可选

销售方编号

SaaS体系入平台、标准商户时必传

<= 64 字符

示例值:

SE20230627XXXXXX

返回响应

🟢200成功

application/json

Body

result

object (mer.BossMerchantNetInStandardApiRespDTO)

可选

老板管账标准版特约商户入网（企业/个体）返回参数

code

string

必需

响应码

示例值:

MAS000000

msg

string

响应消息

可选

"申请已驳回"时，回传的审核意见

示例值:

请求成功

applicationStatus

string

申请状态

必需

REVIEWING:申请审核中
REVIEW_BACK:申请已驳回

示例值:

REVIEWING

applicationNo

string

可选

申请单编号

<= 64 字符

示例值:

TYSHRW20200713999999

requestNo

string

可选

入网请求号

<= 64 字符

merchantNo

string

可选

商户编号

<= 32 字符

示例

{
    "result": {
        "code": "MAS000000",
        "msg": "请求成功",
        "applicationStatus": "REVIEWING",
        "applicationNo": "TYSHRW20200713999999",
        "requestNo": "string",
        "merchantNo": "string"
    }
}

🔴500服务器错误