说明

网商银行门店通道查询这个数据在想用后台如果想获取实时的调取网商商户信息查询接口

请求地址

环境 请求地址
测试环境 https://m.umxnt.com/api/mybank/store
正式环境 https://xy.umxnt.com/api/mybank/store

请求参数

参数 类型 是否必填 最大长度 描述
token string 令牌
store_id string 门店编号
  • 返回值示例 成功请求示例:

    {
      "status": 1,
      "data": {
        "id": 15,
        "status": 0,
        "OrderNo": "2017101311150710080000000000000000028548",
        "OutMerchantId": "2017101317522231213",
        "MerchantId": "226801000000028695451",
        "MerchantName": "南京有梦想科技门店",
        "MerchantType": "02",
        "DealType": "01",
        "SupportPrepayment": "Y",
        "SettleMode": "02",
        "Mcc": "2015063000020189",
        "MerchantDetail": {
          "alias": "有梦想网络科技",
          "contactMobile": "15715168982",
          "contactName": "赵云",
          "province": "320000",
          "city": "320100",
          "district": "320115",
          "address": "天元东路1009号",
          "servicePhoneNo": "15715168982",
          "email": "15715168982@139.com",
          "principalPerson": "南京有梦想科技门店",
          "principalCertType": "01",
          "PrincipalMobile": "15715168982",
          "principalCertNo": "321084198908173614",
          "PrincipalPerson": "赵云",
          "OtherBankCardNo": "6221883120008080768",
          "BussAuthNum": "91320191MA1MYUM491",
          "CertPhotoA": "fd0b4a60-7606-4941-b300-bd2a59fe3f04",
          "CertPhotoB": "a62651ab-54c0-4693-82a3-e82a42c5808b",
          "LicensePhoto": "b29a3d4a-a883-4018-bb9c-4fe158da1eba",
          "ShopPhoto": "172b6b2c-55a7-490c-80d5-413330238d6a"
        },
        "TradeTypeList": "01,02,06",
        "PrincipalCertType": "01",
        "PayChannelList": "01,02",
        "DeniedPayToolList": null,
        "FeeParamList": [
          {
            "channelType": "01",
            "feeType": "01",
            "feeValue": 0.0035
          },
          {
            "channelType": "01",
            "feeType": "02",
            "feeValue": 0.0035
          },
          {
            "channelType": "02",
            "feeType": "01",
            "feeValue": 0.0035
          },
          {
            "channelType": "02",
            "feeType": "02",
            "feeValue": 0.0035
          }
        ],
        "BankCardParam": null,
        "SupportStage": "Y",
        "wx_Path": null,
        "wx_AppId": null,
        "wx_Secret": null,
        "wx_SubscribeAppId": null,
        "is_yulibao": "false",
        "created_at": "2017-10-13 19:02:15",
        "updated_at": "2017-10-13 19:02:15"
      }
    }
    

    返回参数说明

    | 参数名 | 参数描述 | 数据类型 | | :--- | :--- | :--- | | IsvOrgId | 合作方机构号(网商银行分配)。 | String | | OutMerchantId | 外部商户号。合作商对商户的自定义编码,要求同一个合作商下保持唯一。 | String | | MerchantName | 商户名称。有营业执照的,要求与营业执照上的名称一致。 | String | | MerchantType | 商户类型。可选值:01:自然人02:个体工商户03:企业商户 | String | | DealType | 商户经营类型。可选值:01:实体特约商户02:网络特约商户03:实体兼网络特约商户 | String | | SupportPrepayment | 商户清算资金是否支持T+0到账。可选值:Y:支持(企业商户暂不支持垫资)N:不支持备注:从T1改成T0,须将结算方式调整为结算到余利宝,同时必送设置T0费率。 | String | | SettleMode | 结算方式。商户清算资金结算方式,可选值:01:结算到他行卡02:结算到余利宝03:结算到活期户(暂不开放)04:自提打款(暂不开放)备注:选择02时,银行卡字段不须填写,同时须调用开通二类户接口及开通余利宝接口完成后方可受理支付。 | String | | Mcc | 经营类目。参见附录的经营类目上送。 | String | | MerchantDetail | 商户详情列表。json格式base64编码,具体报文定义参考商户详情。 | String | | TradeTypeList | 支持交易类型列表。该商户能支持的交易类型,多个用逗号隔开。可选值:01:正扫交易02:反扫交易06:退款交易 | String | | PayChannelList | 支持支付渠道列表。该商户能支持的第三方支付渠道。多个用逗号隔开。可选值:01:支付宝02:微信支付03:手机QQ(暂未开放)04:京东钱包(暂未开放) | String | | DeniedPayToolList | 禁用支付方式。商户禁受理支付方式列表,多个用逗号隔开。可选值:02:信用卡03:花呗(仅支付宝)备注:微信支付刷卡支付(被扫)模式无法禁用信用卡支付。 | String | | FeeParamList | 手续费列表。json格式base64编码,具体报文定义参考下面的手续费列表 | String | | BankCardParam | 清算卡参数。json格式base64编码,具体报文定义参考下面的清算卡,仅结算方式为“01结算到他行卡”需要填写 | String | | AuthCode | 手机验证码。仅结算方式为“01结算到他行卡”及商户类型为“01自然人、02个体工商户”需要填写。备注:合作方系统须先调网商短信验证码发送接口,商户获取验证码后在申请页面回填验证码,合作方系统通过本接口统一上送。合作机构如不希望做验证码校验,可线下上网商银行申请配置。 | String | | OutTradeNo | 外部交易号。合作方系统生成的外部交易号,同一交易号被视为同一笔交易。 | String | | SupportStage | 该字段用于决定商户是否可自主选择让其买家使用花呗分期,包括商户承担手续费和用户承担手续费两种模式。目前仅支持用户承担手续费模式。可选值:1:支持2:不支持(默认值)该字段2017年9月30日提供线上服务。 | String | | PartnerType | 商户在进行微信支付H5支付时所使用的公众号相关信息的类型,枚举值有:01:商户自有公众号。适合商户本身有公众号的情况。02:其他商户的公众号。适合商户本身没有公众号,可借用其他商户公众号做支付的情况。03:合作机构对接网商时留存的公众号。适合商户本身没有公众号,关注其他商户公众号的情况。备注:由于微信支付要求商户名称和公众号的认证主体要严格一致,商户需要根据自身情况选择一种方式去报送公众号支付相关的信息。该字段不填写默认为03.该字段2017年9月30日提供线上服务。 | String | | | | | | Alias | 商户简称。 | String | | ContactMobile | 联系人手机号。为商户常用联系人联系手机号。 | String | | ContactName | 联系人姓名。为商户常用联系人姓名。 | String | | Province | 省份(按照附录5.6国标省市区号录入)。备注:Province、City、District、Address须同时出现。可选填,一旦填写会做正确性校验。 | String | | City | 城市(按照附录5.6国标省市区号录入)备注:Province、City、District、Address须同时出现。可选填,一旦填写会做正确性校验。 | String | | District | 区(按照附录5.6国标省市区号录入)备注:Province、City、District、Address须同时出现。可选填,一旦填写会做正确性校验。 | String | | Address | 地址(上传后在支付宝的商户等级会更高,有机会使用花呗支付、商家自运营(支付即会员)等功能备注:Province、City、District、Address须同时出现。 | String | | ServicePhoneNo | 商户客服电话 | String | | Email | 邮箱 | String | | LegalPerson | 企业法人名称(注意:是法人名称,即营业执照上的公司名称,非法人代表名称)。自然人或个人工商户无须上送。 | String | | PrincipalMobile | 负责人手机号。自然人或个体工商户上送,企业可不上送。备注:若商户后续开通二类户及余利宝功能,该手机号作为客户在网商的预留手机号,企业可不填)。开户发送的短信验证码的手机号需要和负责人手机号一致。 | String | | PrincipalCertType | 负责人证件类型。可选值:01:身份证 | String | | PrincipalCertNo | 负责人证件号码。备注:若自然人送自然人证件号码、若个体工商户送经营者证件号码、若企业送法人代表证件号码。 | String | | PrincipalPerson | 负责人名称或企业法人代表姓名。备注:若商户类型为“自然人”填写责任人本人,若为“个体工商户”填写经营者本人,若为“企业”填写企业法人代表名称。 | String | | BussAuthNum | 营业执照工商注册号。若商户类型为“自然人”无需上送。 | String | | CertOrgCode | 组织机构代码证号。 | String | | CertPhotoA | 负责人或企业法人代表的身份证图片正面。备注:需要先调商户图片上传接口上传图片获取链接,并将该链接填到本字段。涉及图片上传的接口处理逻辑一致。对应PhotoType字段(图片类型):01 | String | | CertPhotoB | 负责人或企业法人代表的身份证图片反面对应PhotoType字段(图片类型):02 | String | | LicensePhoto | 营业执照图片(若商户类型为“自然人”无需上送)对应PhotoType字段(图片类型):03 | String | | PrgPhoto | 组织机构代码证图片(若商户类型为“自然人”无需上送、“个体工商户”可选)对应PhotoType字段(图片类型):04 | String | | IndustryLicensePhoto | 开户许可证照片(若商户类型为“自然人”无需上送、“个体工商户”可选、企业必送)对应PhotoType字段(图片类型):05 | String | | ShopPhoto | 门头照(店铺门头照,可选)对应PhotoType字段(图片类型):06 | String | | OtherPhoto | 其他图片对应PhotoType字段(图片类型):07 | String | | SubscribeMerchId | 当PartnerType=02时,必填。需要填写借用公众号的商户号,该商户号由网商银行分配。该字段2017年9月30日提供线上服务。 | String | | Path | 公众号授权目录,用于微信公众号调起JSapi支付。本字段不填写默认使用合作方在网商预留的公众号授权目录。当PartnerType=01时,必填。该字段2017年9月30日提供线上服务。 | String | | AppId | 用于微信支付的公众号主体的APPID。本字段不填写默认使用合作方在网商预留的公众号Appid。当PartnerType=01时,必填。该字段2017年9月30日提供线上服务。 | String | | SubscribeAppId | 上送需关注的公众号对应的APPID,用于买家完成公众号支付后自动关注的公众号。本字段不填写默认使用合作方在网商预留的公众号。当PartnerType=01时,必填。该字段2017年9月30日提供线上服务。 | String | | | | | | ChannelType | 渠道类型。可选值:01:支付宝02:微信支付 | String | | FeeType | 费用类型。可选值:01:t0收单手续费02:t1收单手续费备注:支持t0清算的商户必选设置t0、t1费率 | String | | FeeValue | 费率。例如:千分之3.5直接送0.0035备注:费率注意不要超出网商银行给合作方设定的范围 | String | | | | | | BankCardNo | 银行卡号备注:银行卡号、开户人名称及开户人证件号码等信息会进行核身,核身不通过无法完成商户进驻,合作方须注意银行卡信息的正确性。 | String | | BankCertName | 开户人名称。当商户类型是“01自然人”、“02个人工商户”时,开户人与须与负责人名称一致;当商户类型是“03企业商户”时,须与企业法人名称一致。 | String | | AccountType | 账户类型。可选值:01:对私账户(自然人、个体工商户可选)02:对公账户(企业类型才可选填写) | String | | ContactLine | 联行号。备注:1、MerchantType=03企业商户,必须上送正确的联行号,否则导致清算打款失败。2、使用全国联行号表。填了联行号以联行号为准,不再与开户支行名称、开户支行省、市的参数进行匹配。 | String | | BranchName | 开户支行名称 | String | | BranchProvince | 开户支行所在省(按照附录5.6国标省市区号录入) | String | | BranchCity | 开户支行所在市(按照附录5.6国标省市区号录入) | String | | CertType | 持卡人证件类型。可选值:01:身份证对公账户不需要填写。 | String | | CertNo | 持卡人证件号码对公账户不需要填写。 | String | | CardHolderAddress | 持卡人地址对公账户不需要填写。 | String |

  • {
        "msg":"无效参数",
        "status":0
    }
    

results matching ""

    No results matching ""