> ## 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.

# 银联报备结果查询

## 功能说明

按**机构进件申请单号**查询商户在支付机构的银联报备结果，返回银联商户号与报备状态。

* 请求键为机构进件申请单号：`apply_no` 取自[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)响应的 `institutions[].apply_no`，**不是**商户录入时的 `out_apply_no`；
* 报备由机构侧异步完成，未完成时以机构返回结果为准；报备成功后商户可使用银联相关产品；
* 仅可使用本主体凭证查询。

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

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

**请求路径**：`/openapi/v1/merchant/unionpay/query`

## 请求参数

| 字段 | 是否必填 | 字段类型 | 字段说明 |
| - | - | - | - |
| `apply_no` | 是 | String(≤64) | 机构进件申请单号，取自[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)的 `institutions[].apply_no` |

## 响应参数

| 字段 | 是否必填 | 字段类型 | 字段说明 |
| - | - | - | - |
| `unionpay_merchant_no` | 否 | String | 银联商户号，报备成功且机构返回时非空 |
| `apply_status` | 是 | String | 报备结果：`SUCCESS`=成功 / `FAIL`=失败 |
| `fail_reason` | 否 | String | 报备失败原因，`apply_status=FAIL` 时非空 |

## 示例

**请求**

```json theme={"system"}
{
  "apply_no": "APL26101808571000003"
}
```

**响应（报备成功）**

```json theme={"system"}
{
  "unionpay_merchant_no": "898110000000001",
  "apply_status": "SUCCESS",
  "fail_reason": ""
}
```

**响应（报备失败）**

```json theme={"system"}
{
  "unionpay_merchant_no": "",
  "apply_status": "FAIL",
  "fail_reason": "银联报备信息不完整"
}
```

**失败示例（参数错误）**

```json theme={"system"}
{
  "code": 400,
  "reason": "PARAM_ERROR",
  "message": "apply_no 不能为空",
  "metadata": {}
}
```

> [!NOTE]
>
> 银联报备是机构进件完成后的独立步骤，报备结果不影响进件状态；进件进度与机构商户号以[进件状态查询](https://opendocs.xft.xin/open/payment/merchant/apply-query.md)为准。


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