接口描述:

  • 查询商户信息接口

接口版本：

版本号 制定人 制定日期 修订日期
1.0.0 高俭 2020-05-6 2020-05-06

请求URL

请求方式

  • POST

请求参数

参数名 变量名 类型 是否必须 说明
商户类型 merType string M 0：MPOS（手刷） 1：POS（传统）
商户编号 merId string M 收单机构返回的商户编号
随机字符串 nonce_str string M 32位随机字符串
签名类型 sign_type string O 签名算法类型，默认MD5
签名 sign string M 签名字符串

请求示例

{
    "nonce_str":"hhjjwwjjuu7766522ju765dgt543256h",
    "sign":"70A4C475DB8243810875BD738BFCA2A7",
    "merId": "881100042250122",
    "merType":"0"
}

返回示例

正确时返回:

{
    "code": "0000",
    "data": {
        "merId": "881100042250122",
        "sign": "70A4C475DB8243810875BD738BFCA2A7",
        "nonce_str": "hhjjwwjjuu7766522ju765dgt543256h",
        "agentNumber": "503",
        "mobileNumber": "13699899888",
        "name": "信瑞泰测试",
        "registerProvince": "北京市",
        "registerCity": "北京",
        "registerArea": "朝阳区",
        "registerAddr": "酒仙桥",
        "regCapital": "100",
        "registerNo": "188115429291222",
        "busliceStartDate": "2018-01-01",
        "busliceEndDate": "2020-01-01",
        "busliceRegName": "服务商1测试",
        "legalName": "高先生",
        "legalCertType": "01",
        "legalCertCode": "430426199102100006",
        "linkManPhone": "13899998888",
        "linkManName": "高老师",
        "linkManEmail": " ",
        "dLinkManName": "高先生",
        "dLinkManMobileNo": "13599880077",
        "merPro": "1",
        "MCC": "4225",
        "runBusiness": " ",
        "settleMethod": "01",
        "settleAccType": "1",
        "settleAccName": "高老师",
        "settleAccNo": "11220000999988886666",
        "settleAccIdCard": "430426199102100006",
        "settleBranchBank": "中国民生银行股份有限公司北京回龙观支行",
        "bankBranchNo": "305100001660",
        "shopInfo": "",
        "debitUpperLimit": "1700",
        "debitFeeRate": "0.0041",
        "creditFeeRate": "0.0054",
        "overseaDebitFeeRate": "0",
        "overseaCreditFeeRate": "0",
        "cupQrFeeRate": "0",
        "alipayQrFeeRate": "0",
        "wechatQrFeeRate": "0",
        "serviceFee": "0",
        "merLevel": "2",
        "redShieldQualityUrl": "www.baidu.com",
        "auditState": "",
        "reason": ""
    },
    "msg": "处理成功"
}

错误时返回:

{
    "code": "4000",
    "msg": "处理失败"
}

返回参数说明:

参数名 变量名 类型 说明
状态码 code string 0000为成功，其他都为失败
状态描述 msg string 状态描述
返回数据详情 data JsonObject 返回数据详情
随机字符串 nonce_str string 32位随机字符串
签名 sign string 签名字符串
商户编号 merId string 模式一：“3.2 新增商户信息”接口返回的 merId为收单机构银联标准商编，则该报文中的 merId与 3.2.3 报文中的 merId 一致，格式如下：”merId”:”881100042250001”。模式二：“3.2 新增商户信息”接口返回的 merId为收单机构自定义商编，则该报文中的 merId 格式如下：”merId”:”{"platMerId":"881100042250001","cupMerId":"881100042250001"}”；说明：platMerId 为收单机构自定义商编，cupMerId 为收单机构银联标准商编，其中 platMerId 必填，cupMerId 当收单机构已生成对应银联标准商编时必填；当报文中包含 cupMerId 时，服务商商户应将商户编号更新，以审核通知 cupMerId 为最终商编。
服务商编号 agentNumber string 服务商编号
注册手机号 mobileNumber string 注册的手机号或者邮箱
商户名称 name string 商户名称
注册地址所属省 registerProvince string 注册省名全称 如浙江省
注册地址所属市 registerCity string 注册市名全称 如杭州市
注册地址所属区 registerArea string 注册区名或县名全称 如西湖区
注册地址 registerAddr string 商户注册地址
注册资本 regCapital string 单位：万元
注册登记号 registerNo string 工商注册号（不可重复）
营业执照有效期始 busliceStartDate string 格式：yyyy-MM-dd
营业执照有效期止 busliceEndDate string 格式：yyyy-MM-dd
营业执照注册名称 busliceRegNameANS1 string 营业执照注册名称
法人姓名 legalName string
法人证件类型 legalCertType string 01：身份证，02：户口本，03 护照
法人证件号码 legalCertCode string
法人联系人手机 linkManPhone string
联系人姓名 linkManName string
联系人邮箱 linkManEmail string
调单联系人姓名 dLinkManName string
调单联系人手机 dLinkManMobileNo string
商户性质 merPro string 0：自然人:1：个体: 2：企业
商户MCC mcc string 商户MCC
经营业务 runBusiness string 如服装零售，餐饮，住宿等
结算方式 settleMethod string 01：T1，02：D0，03：D1
结算账户类型 settleAccType string 0：对公；1：对私
结算账号户名 settleAccName string
结算账号 settleAccNo string
结算账号身份证号 settleAccIdCard string
结算银行支行名称 settleBranchBank string 结算银行支行名称
结算支行联行号 bankBranchNo string 结算支行就联行号
门店信息 shopInfo string 每个商户支持多个门店，字段值为 json 数组的形式，具体字段见附表一
借记卡费率封顶值 debitUpperLimit string 单位（分）
借记卡费率 debitFeeRate string 例：千分之五为 0.00500，支持五位小数
贷记卡费率 creditFeeRate string 例：千分之五为 0.00500，支持五位小数
境外借记卡费率 overseaDebitFeeRate string 例：千分之五为 0.00500，支持五位小数
境外贷记卡费率 overseaCreditFeeRate string 例：千分之五为 0.00500，支持五位小数
银联扫码费率 cupQrFeeRate string 例：千分之五为 0.00500，支持五位小数
支付宝扫码费率 alipayQrFeeRate string 例：千分之五为 0.00500，支持五位小数
微信扫码费率 wechatQrFeeRate string 例：千分之五为 0.00500，支持五位小数
清算服务费 serviceFee string 单位（分）
商户级别 merLevel string 商户的级别（1：A 级，2：B 级，3：C 级）
红盾网链接 redShieldQualityUrl string 红盾网链接
审核状态 checkState string 0：拒绝 1：通过 2：待审核
审核原因 reason string 当审核状态为 0：拒绝，1：通过时应填写

附表一：

  • 门店信息 shopInfo
    shopInfo 子域采用嵌套 JSON 格式，全部内容用“{ }”包含，内部可包含多个字段，字段定义如下表：
参数名 变量名 类型 说明
门店名称 shopName string 门店名称
门店地址 shopAddr string 门店地址
门店联系人 shopLinkManName string 门店联系人
门店联系人电话 shopLinkManPhone string 门店联系人电话
pos 安装省 shopProvince string 注册省名全称 如浙江省
pos 安装市 shopCity string 注册市名全称 如杭州市
终端信息 termInfo string 每个门店支持多个 pos，字段值为 json 数组的形式，具体字段见附表二，例如:“copId”：”000031”，“trmmodNo”：”700” ， “posSerialNo”：”1234523” }，{ “copId”：”000031” ， “trmmodNo”：” 700” ， “posSerialNo”：”1234523”}]

附表二:

  • 门店信息 pos
    pos 子域采用嵌套 JSON 格式，全部内容用“{ }”包含，内部可包含多个字段，字段定义如下表：
参数名 变量名 类型 说明
机具类型 posType string 0：POS 机，1：音频 POS，2：盒子刷卡器，3：音频 POSMini
POS通讯方式 posCate string 0：固定 POS ；1：移动 POS； 2：电话 POS
终端厂商编号 copId string 000031：福建魔方 000002：百富 000006：华智融 000012：实达 000003：新大陆
POS 型号 termModNo string POS 型号
POS 序列号 posSerialNo string 8 位以上数字或字母（不可重复）

备注:

  • 更多返回错误代码请看附录的错误代码描述
文档更新时间: 2020-11-03 17:35   作者：高俭