> ## Documentation Index
> Fetch the complete documentation index at: https://opendocs.xft.xin/llms.txt
> Use this file to discover all available pages before exploring further.

# 机构商户信息查询

## 功能说明

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

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

**支持商户**：全部已开通进件权限的渠道商（及其旗下品牌）

**请求方式**：`POST`

**请求路径**：`/openapi/v1/merchant/institution/info`

## 请求参数

| 字段 | 是否必填 | 字段类型 | 字段说明 |
| - | - | - | - |
| `merchant_code` | 是 | String(≤64) | 平台商户号 |
| `institution_code` | 是 | String(≤64) | 支付机构编码，见[支付机构列表](https://opendocs.xft.xin/open/payment/appendix/institutions.md) |

## 响应参数

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

## 示例

**请求**

```json theme={"system"}
{
  "merchant_code": "801292371559190",
  "institution_code": "EASYPAY"
}
```

**响应**

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

**失败示例（商户不存在）**

```json theme={"system"}
{
  "code": 400,
  "reason": "NOT_FOUND",
  "message": "商户不存在",
  "metadata": {}
}
```

> [!NOTE]
>
> 本接口返回机构侧原始数据，字段含义与编码请对照机构文档；平台侧统一状态请使用[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)与[商户查询](https://opendocs.xft.xin/open/payment/merchant/merchant-query.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.