机构商户信息查询 - 星惠付开放平台

功能说明

查询商户在指定支付机构侧的完整商户信息（机构商户号、商户名称、经营类型、MCC、地区码、经营地址、商户状态）。

请求必须同时指定 merchant_code 与 institution_code，按机构维度查询；
响应字段为机构侧返回值的原样透传（经营类型、MCC、地区码、商户状态的编码体系以机构为准）；
仅可查询本主体录入的商户（渠道商可查询旗下品牌录入的商户），否则返回 403 PERMISSION_DENIED。

支持商户：全部已开通进件权限的渠道商（及其旗下品牌） 请求方式：POST 请求路径：/openapi/v1/merchant/institution/info

请求参数

字段	是否必填	字段类型	字段说明
`merchant_code`	是	String(≤64)	平台商户号
`institution_code`	是	String(≤64)	支付机构编码，见支付机构列表

响应参数

字段	是否必填	字段类型	字段说明
`institution_merchant_code`	否	String	机构侧商户号
`merchant_name`	否	String	机构侧登记的商户名称
`business_type`	否	String	商户经营类型，机构原始编码
`mcc_code`	否	String	商户 MCC 编码
`area_code`	否	String	商户银联地区码，机构原始编码
`business_address`	否	String	商户经营地址
`merchant_status`	否	String	机构侧商户状态，机构原始编码

示例

请求

{
  "merchant_code": "801292371559190",
  "institution_code": "EASYPAY"
}

响应

{
  "institution_merchant_code": "890000000000001",
  "merchant_name": "杭州西湖云帆智慧零售有限公司",
  "business_type": "5712",
  "mcc_code": "5411",
  "area_code": "330106",
  "business_address": "浙江省杭州市西湖区文三路 100 号",
  "merchant_status": "1"
}

失败示例（商户不存在）

{
  "code": 400,
  "reason": "NOT_FOUND",
  "message": "商户不存在",
  "metadata": {}
}

本接口返回机构侧原始数据，字段含义与编码请对照机构文档；平台侧统一状态请使用进件状态查询与商户查询。

​功能说明

​请求参数

​响应参数

​示例

功能说明

请求参数

响应参数

示例