3.1.1 商户信息录入 - 汇联开放平台

1、用于录入商户信息。
2、进件结果会异步通知。
3、进件审核驳回请使用相同的mchOrderNo商户报备单号修改后提交
4、如果进件的是间联汇付宝渠道，如果是小微或者个体户需要在经营信息内其他文件中上传4张图片，按照以下顺序依次上传，不可变动顺序，
① 结算银行卡背面（个体）
② 结算银行卡所有者手持银行卡正面图片（个体/小微）
③ 法人手持身份证正面（个体/小微）
④ 法人手持银行卡卡号（个体/小微）

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

Body 参数application/json

appId

string

应用APPID

必需

商户应用APPID

subSn

string | null

子商户编码

可选

非必传项，目前仅代理商/服务商可传，普通商户和平台商户请勿传入

timestamp

string

时间戳

必需

请求时间戳单位秒，要求timestamp与当前时间间隔在60秒以内

requestId

string

请求id

必需

请求唯一标识，无其他意义，必须每一次请求不允许重复，用于定位问题

signType

string

签名方式

必需

固定值：RSA2

sign

string

签名

必需

参照签名方法

bizContent

object (商户进件信息)

必需

由于工具限制，该字段必须转为JSON 格式字符串，请注意

mchOrderNo

string

商户报备单号

必需

不可重复，审核驳回修改时使用同一单号进行提交

providerCode

string

服务商编码

必需

可联系对接业务获取

默认值:

S1524906003

channelCode

string

渠道编码

必需

可联系对接业务获取

示例值:

heepay=汇元银通

notifyUrl

string

审核状态异步通知地址

可选

不传将不会进行通知

merchantAccessInfo

object

商户信息

必需

商户信息串

merchantAccessBusiness

object

经营信息

必需

merchantAccessCard

object

结算信息

必需

feeInfoType

number

支付产品报文类型

可选

1=平台模式，2=渠道模式，默认为平台模式

feeInfo

array [object {6}]

支付产品开通

可选

如果是默认平台模式请按以下参数传入，如果是渠道模式请联系运营获取渠道模式传参报文

示例

{
    "appId": "APP_8428691003",
    "subSn": null,
    "timestamp": "1736145411",
    "requestId": "51d6fb4a-06f8-40c7-ad28-1546c043fbfc",
    "signType": "RSA2",
    "bizContent": {
        "mchOrderNo": "36c3c235-77f6-4d7e-855c-628577143576",
        "providerCode": "S1524906003",
        "channelCode": "heepay",
        "notifyUrl": "https://optimal-other.org/",
        "merchantAccessInfo": {
            "merchantAccessType": 1,
            "type": 2,
            "merchantAccessLicense": {
                "companyType": "3",
                "name": "天津市鸿煊旅游发展股份有限公司",
                "licenseUrl": "https://loremflickr.com/311/120?lock=5446407080559251",
                "licenseCode": "91f24efd-f491-49e7-9c14-2952405291c6",
                "licenseType": "2",
                "licenseValidityType": 1,
                "licenseBeginDate": "2024-01-15",
                "licenseEndDate": "2025-11-15",
                "registrationDate": "2024-02-13",
                "registeredCapital": "9",
                "businessScope": "国际",
                "provinceCode": "7",
                "cityCode": "9",
                "areaCode": "8",
                "address": "维件器事向因热装。为中热被亲型米。命当约行目儿。\n风基到议它接周使从论。见太动林。深办酸单据半运和。\n起众但定通着活。工约次素。口带院铁造还这较历。"
            },
            "merchantAccessLegal": {
                "name": "曾婷方",
                "phone": "14314510294",
                "address": "端巷86184号",
                "certType": "1",
                "certNo": "650102193203302627",
                "certValidityType": 1,
                "certBeginDate": "2024-04-07",
                "certEndDate": "2024-01-22",
                "certFrontUrl": "https://picsum.photos/seed/S03SEmWhIQ/2664/572",
                "certBackUrl": "https://loremflickr.com/294/1631?lock=6140998369003733",
                "email": "k5qkfk.poy46@gmail.com"
            },
            "contactType": 1,
            "merchantAccessContact": {
                "name": "苍梓萱",
                "phone": "19052525175",
                "address": "48号门牌",
                "certType": "1",
                "certNo": "530102197612050310",
                "certValidityType": 1,
                "certBeginDate": "2025-04-16",
                "certEndDate": "2025-04-17",
                "certFrontUrl": "https://picsum.photos/seed/HVuYSAO86d/3983/2313",
                "certBackUrl": "https://loremflickr.com/2697/2387?lock=2529642993165465",
                "email": "ryilj113@yahoo.cn"
            },
            "controllerType": 1,
            "merchantAccessController": {
                "name": "定丽",
                "phone": "16970706994",
                "address": "俟街73918号",
                "certType": "1",
                "certNo": "450100201102266118",
                "certValidityType": 1,
                "certBeginDate": "2025-10-17",
                "certEndDate": "2024-02-28",
                "certFrontUrl": "https://picsum.photos/seed/stNPUTbHC/3735/1464",
                "certBackUrl": "https://loremflickr.com/3935/2435?lock=2254523555972200"
            },
            "merchantAccessBenefitList": [
                {
                    "name": "z",
                    "phone": "16107461644",
                    "address": "上海市 济乡县 西城区 狄街3号 87号楼",
                    "certType": "laborum elit",
                    "certNo": "voluptate sunt",
                    "certValidityType": "1",
                    "certBeginDate": "2024-08-24",
                    "certEndDate": "2024-04-07",
                    "certFrontUrl": "https://linear-airman.net/",
                    "certBackUrl": "https://valuable-cornet.info/"
                }
            ],
            "merchantAccessShareholderList": [
                {
                    "name": "z",
                    "phone": "90739883048",
                    "address": "西藏自治区 厦码市 临沭县 夙旁2号 33号楼",
                    "certType": "qui non nostrud",
                    "certNo": "non tempor Duis",
                    "certValidityType": "1",
                    "certBeginDate": "2024-05-05",
                    "certEndDate": "2024-03-20",
                    "certFrontUrl": "https://fearless-nucleotidase.org/",
                    "certBackUrl": "https://stable-chainstay.biz/"
                },
                {
                    "name": "z",
                    "phone": "86763787463",
                    "address": "山西省 珠汉市 雨城区 满桥5918号 41室",
                    "certType": "culpa",
                    "certNo": "sint consectetur dolore velit dolor",
                    "certValidityType": "1",
                    "certBeginDate": "2024-04-01",
                    "certEndDate": "2025-08-08",
                    "certFrontUrl": "https://warlike-eternity.org/",
                    "certBackUrl": "https://affectionate-monster.name/"
                }
            ]
        },
        "merchantAccessBusiness": {
            "shortName": "智能的棉花键盘",
            "mcc": "10000",
            "wechatMcc": "10000",
            "alipayMcc": "10000",
            "storeHeaderUrl": "https://loremflickr.com/3802/3013?lock=6224329059810695",
            "storeIndoorUrl": "https://picsum.photos/seed/rIwS7V/2498/3980",
            "storeCashierDeskUrl": "https://picsum.photos/seed/1FioTfa/2315/3531",
            "servicePhone": "0450-02194002",
            "provinceCode": "100000",
            "cityCode": "100000",
            "areaCode": "100000",
            "address": "沐栋224号",
            "officeSpace": "100",
            "officeSpaceType": 1,
            "businessDesc": "测试测试测试",
            "businessLicenses": [
                {
                    "name": "貊玉英",
                    "licenseUrl": "https://devoted-chiffonier.net/",
                    "licenseValidityType": "5",
                    "licenseBeginDate": "2025-05-22",
                    "licenseEndDate": "2025-03-12"
                }
            ],
            "fileUrls": null,
            "merchantAccessSceneList": null,
            "sceneType": 2
        },
        "merchantAccessCard": {
            "type": 1,
            "name": "章佳语汐",
            "cardNo": "97ee48c2-fdd7-4459-b926-426490db83a9",
            "bankCode": "10000",
            "bankName": "10000",
            "branchCode": "102120120121",
            "officialName": "诸海市潇然建设（集团）有限公司",
            "officialCardNo": "7d2fe990-d313-423c-9bf6-755aaa8fd9ed",
            "officialBankCode": "71",
            "officialBankName": "练欣怡",
            "officialBranchCode": "86",
            "officialProvinceCode": "江西省",
            "officialCityCode": "9",
            "officialAreaCode": "43",
            "certType": "reprehenderit consequat ullamco",
            "certFrontUrl": "https://agile-ruin.net/",
            "certBackUrl": "https://milky-status.com/",
            "certNo": "ea laborum enim Ut",
            "certValidityType": 1,
            "certBeginDate": "2025-01-03",
            "certEndDate": "2024-12-10",
            "provinceCode": "河北省",
            "cityCode": "4",
            "areaCode": "62",
            "cardPhone": "越野车",
            "settleCardFrontUrl": "https://gorgeous-provision.name/",
            "settleCertFrontUrl": "https://bright-fuel.org/",
            "settleCertBackUrl": "https://slimy-subsidy.biz/",
            "licenseUrl": "https://sarcastic-settler.biz/",
            "licenseNo": "laboris veniam anim in",
            "authUrl": "https://acclaimed-courtroom.org/",
            "settleCycle": 2
        }
    },
    "sign": "H6oAMOljItjCsEC72RmZ/s9VFg/BFZbv3oPtUKjoM7w3jeNgCLOrFASD0o3Qbesnd9xkCbT62IJt/sNBvs47ja02X2QGBYg5+aXIZ6zn6Uu+HegqdMYBTtjrY3t2sBHVr+QK5mZo59Ic7baVEz4NTBkS/BPbtlrwIvbcqq9quSZ5vCyBt/nkXUNy0JgxtzCofwT8I4pKWUQcWovI+AIt/a0wW8VOcoKA+vif4DmiNK0BitypOYpr4aFDZodj8DYdBRXQFA12KRCk1q3HERvQSLE33FAg+xF+LOKy2zLucqdjgzBSwne0CVOhjKDXU9EdQO1bH+fRam9A83HT0sUJsw=="
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.qywh8.com/openapi/merchant/access/submit' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "APP_8428691003",
    "subSn": null,
    "timestamp": "1736145411",
    "requestId": "51d6fb4a-06f8-40c7-ad28-1546c043fbfc",
    "signType": "RSA2",
    "bizContent": {
        "mchOrderNo": "36c3c235-77f6-4d7e-855c-628577143576",
        "providerCode": "S1524906003",
        "channelCode": "heepay",
        "notifyUrl": "https://optimal-other.org/",
        "merchantAccessInfo": {
            "merchantAccessType": 1,
            "type": 2,
            "merchantAccessLicense": {
                "companyType": "3",
                "name": "天津市鸿煊旅游发展股份有限公司",
                "licenseUrl": "https://loremflickr.com/311/120?lock=5446407080559251",
                "licenseCode": "91f24efd-f491-49e7-9c14-2952405291c6",
                "licenseType": "2",
                "licenseValidityType": 1,
                "licenseBeginDate": "2024-01-15",
                "licenseEndDate": "2025-11-15",
                "registrationDate": "2024-02-13",
                "registeredCapital": "9",
                "businessScope": "国际",
                "provinceCode": "7",
                "cityCode": "9",
                "areaCode": "8",
                "address": "维件器事向因热装。为中热被亲型米。命当约行目儿。\n风基到议它接周使从论。见太动林。深办酸单据半运和。\n起众但定通着活。工约次素。口带院铁造还这较历。"
            },
            "merchantAccessLegal": {
                "name": "曾婷方",
                "phone": "14314510294",
                "address": "端巷86184号",
                "certType": "1",
                "certNo": "650102193203302627",
                "certValidityType": 1,
                "certBeginDate": "2024-04-07",
                "certEndDate": "2024-01-22",
                "certFrontUrl": "https://picsum.photos/seed/S03SEmWhIQ/2664/572",
                "certBackUrl": "https://loremflickr.com/294/1631?lock=6140998369003733",
                "email": "k5qkfk.poy46@gmail.com"
            },
            "contactType": 1,
            "merchantAccessContact": {
                "name": "苍梓萱",
                "phone": "19052525175",
                "address": "48号门牌",
                "certType": "1",
                "certNo": "530102197612050310",
                "certValidityType": 1,
                "certBeginDate": "2025-04-16",
                "certEndDate": "2025-04-17",
                "certFrontUrl": "https://picsum.photos/seed/HVuYSAO86d/3983/2313",
                "certBackUrl": "https://loremflickr.com/2697/2387?lock=2529642993165465",
                "email": "ryilj113@yahoo.cn"
            },
            "controllerType": 1,
            "merchantAccessController": {
                "name": "定丽",
                "phone": "16970706994",
                "address": "俟街73918号",
                "certType": "1",
                "certNo": "450100201102266118",
                "certValidityType": 1,
                "certBeginDate": "2025-10-17",
                "certEndDate": "2024-02-28",
                "certFrontUrl": "https://picsum.photos/seed/stNPUTbHC/3735/1464",
                "certBackUrl": "https://loremflickr.com/3935/2435?lock=2254523555972200"
            },
            "merchantAccessBenefitList": [
                {
                    "name": "z",
                    "phone": "16107461644",
                    "address": "上海市 济乡县 西城区 狄街3号 87号楼",
                    "certType": "laborum elit",
                    "certNo": "voluptate sunt",
                    "certValidityType": "1",
                    "certBeginDate": "2024-08-24",
                    "certEndDate": "2024-04-07",
                    "certFrontUrl": "https://linear-airman.net/",
                    "certBackUrl": "https://valuable-cornet.info/"
                }
            ],
            "merchantAccessShareholderList": [
                {
                    "name": "z",
                    "phone": "90739883048",
                    "address": "西藏自治区 厦码市 临沭县 夙旁2号 33号楼",
                    "certType": "qui non nostrud",
                    "certNo": "non tempor Duis",
                    "certValidityType": "1",
                    "certBeginDate": "2024-05-05",
                    "certEndDate": "2024-03-20",
                    "certFrontUrl": "https://fearless-nucleotidase.org/",
                    "certBackUrl": "https://stable-chainstay.biz/"
                },
                {
                    "name": "z",
                    "phone": "86763787463",
                    "address": "山西省 珠汉市 雨城区 满桥5918号 41室",
                    "certType": "culpa",
                    "certNo": "sint consectetur dolore velit dolor",
                    "certValidityType": "1",
                    "certBeginDate": "2024-04-01",
                    "certEndDate": "2025-08-08",
                    "certFrontUrl": "https://warlike-eternity.org/",
                    "certBackUrl": "https://affectionate-monster.name/"
                }
            ]
        },
        "merchantAccessBusiness": {
            "shortName": "智能的棉花键盘",
            "mcc": "10000",
            "wechatMcc": "10000",
            "alipayMcc": "10000",
            "storeHeaderUrl": "https://loremflickr.com/3802/3013?lock=6224329059810695",
            "storeIndoorUrl": "https://picsum.photos/seed/rIwS7V/2498/3980",
            "storeCashierDeskUrl": "https://picsum.photos/seed/1FioTfa/2315/3531",
            "servicePhone": "0450-02194002",
            "provinceCode": "100000",
            "cityCode": "100000",
            "areaCode": "100000",
            "address": "沐栋224号",
            "officeSpace": "100",
            "officeSpaceType": 1,
            "businessDesc": "测试测试测试",
            "businessLicenses": [
                {
                    "name": "貊玉英",
                    "licenseUrl": "https://devoted-chiffonier.net/",
                    "licenseValidityType": "5",
                    "licenseBeginDate": "2025-05-22",
                    "licenseEndDate": "2025-03-12"
                }
            ],
            "fileUrls": null,
            "merchantAccessSceneList": null,
            "sceneType": 2
        },
        "merchantAccessCard": {
            "type": 1,
            "name": "章佳语汐",
            "cardNo": "97ee48c2-fdd7-4459-b926-426490db83a9",
            "bankCode": "10000",
            "bankName": "10000",
            "branchCode": "102120120121",
            "officialName": "诸海市潇然建设（集团）有限公司",
            "officialCardNo": "7d2fe990-d313-423c-9bf6-755aaa8fd9ed",
            "officialBankCode": "71",
            "officialBankName": "练欣怡",
            "officialBranchCode": "86",
            "officialProvinceCode": "江西省",
            "officialCityCode": "9",
            "officialAreaCode": "43",
            "certType": "reprehenderit consequat ullamco",
            "certFrontUrl": "https://agile-ruin.net/",
            "certBackUrl": "https://milky-status.com/",
            "certNo": "ea laborum enim Ut",
            "certValidityType": 1,
            "certBeginDate": "2025-01-03",
            "certEndDate": "2024-12-10",
            "provinceCode": "河北省",
            "cityCode": "4",
            "areaCode": "62",
            "cardPhone": "越野车",
            "settleCardFrontUrl": "https://gorgeous-provision.name/",
            "settleCertFrontUrl": "https://bright-fuel.org/",
            "settleCertBackUrl": "https://slimy-subsidy.biz/",
            "licenseUrl": "https://sarcastic-settler.biz/",
            "licenseNo": "laboris veniam anim in",
            "authUrl": "https://acclaimed-courtroom.org/",
            "settleCycle": 2
        }
    },
    "sign": "H6oAMOljItjCsEC72RmZ/s9VFg/BFZbv3oPtUKjoM7w3jeNgCLOrFASD0o3Qbesnd9xkCbT62IJt/sNBvs47ja02X2QGBYg5+aXIZ6zn6Uu+HegqdMYBTtjrY3t2sBHVr+QK5mZo59Ic7baVEz4NTBkS/BPbtlrwIvbcqq9quSZ5vCyBt/nkXUNy0JgxtzCofwT8I4pKWUQcWovI+AIt/a0wW8VOcoKA+vif4DmiNK0BitypOYpr4aFDZodj8DYdBRXQFA12KRCk1q3HERvQSLE33FAg+xF+LOKy2zLucqdjgzBSwne0CVOhjKDXU9EdQO1bH+fRam9A83HT0sUJsw=="
}'

返回响应

🟢200OK

application/json

Body

code

integer

请求状态

必需

返回200=成功，其他状态均为失败

data

object

返回数据体

可选

返回数据体，失败时不会返回

providerCode

string

服务商编码

可选

channelCode

string

渠道编码

可选

name

string

商户名称

可选

shortName

string

商户简称

可选

contactName

string

联系人名称

可选

contactPhone

string

联系人手机号

可选

contactEmail

string

联系人邮箱

可选

status

integer

审核状态

必需

2：初审中，3：机审中，4：渠道审核中，5：银行审核中，6：待签约，7：签约中，8：待配置，9：配置中，10：审核完成，11：审核驳回

subMchId

string

渠道子商户号

可选

requestId

string

平台请求单号

必需

message

string

信息提示

可选

mchChannelCode

string

用户识别码

可选

收单子商户审核完成必反，重要，交易时需要用到

msg

string

返回信息

必需

appId

string

应用APPID

可选

string

商户编码

可选

sign

string

签名

可选

timestamp

string

时间戳

可选

signType

string

签名方式目前仅支持RSA2

可选

示例

{
    "code": 200,
    "data": {
        "mchOrderNo": xxxxxxxxx,
        "providerCode": "xxxxxxxxx",
        "channelCode": "lakala",
        "name": "xxxxxxxxx",
        "shortName": "汇联物联",
        "contactName": "xxxxxxxxx",
        "contactPhone": "xxxxxxxxx",
        "contactEmail": "san@xxxxxxxxx.com",
        "status": 10,
        "subMchId": "xxxxxxxxx",
        "requestId": "xxxxxxxxx",
        "message": "",
        "mchChannelCode": "xxxxxxxxx"
    },
    "msg": "成功",
    "appId": "APP_1961555003",
    "sn": "M961524003",
    "sign": "Nm/j1iin7uulj9is+vUbDYzzJXSiGW7QdWQ2wrPG/AEAk8j5buRUEudFR7c3LRg/8NfR/TCevif8EPygMXFZUmSU8CCPI9GOeafWRuqXejchLaPlNVGU1rGwi/PN4QjSCnep98vllebAanCRTtGh6X86CevxflmncZstntr/hKpZwwLCLZuWFb64UCZFqWH2ybDA+GIKUQUrG8tcvGHArwBJi7Xw1JXNrhgfwKLgIJqcNa505WzgSaY79fhuo3tu4Y2r7hw7w0BFPFdi3mxcZcq3OkAsrFFfcczUOFEaO3zY1oC5l13/8SWTuqSedmbLS3QsMgN15ZJdZ2U4kvoQYw==",
    "timestamp": "1735281354",
    "signType": "RSA2"
}