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

# 微信商户新增APPID

## 功能说明

JSAPI 支付（公众号/小程序内支付）需要商户的微信子商户号与 APPID 完成关联。本接口供渠道商为已进件商户提交微信 APPID 关联申请，平台审核通过后同步至微信商户平台完成关联，商户即可使用 JSAPI 支付。

* 关联申请由平台审核，**审核通过后同步生效**，无需渠道商登录微信商户平台操作；
* 每个使用 JSAPI 支付的产品（`WECHAT_JSAPI`/`WECHAT_APPLET`）均需完成 APPID 关联；
* 关联的 APPID 主体需与子商户号同主体或已完成授权；
* 驳回后重新提交（同 `out_apply_no` 覆盖重提）。

## 请求地址

`POST https://gw.xft.xin/openapi/v1/merchant/wechat/appid`

## 请求参数

| 字段                          | 是否必选 | 字段类型        | 字段说明                                                |
| --------------------------- | ---- | ----------- | --------------------------------------------------- |
| `out_apply_no`              | 是    | String(≤64) | 申请单号，业务幂等键，同一渠道商下唯一                                 |
| `merchant_code`             | 是    | String      | 平台商户号，进件成功后在通知与[进件状态查询](../merchant/apply-query)中下发 |
| `app_id_list`               | 是    | Array       | APPID 配置列表，关联的 APPID 全量提交（不含已关联项视为解绑）               |
| `app_id_list[].app_id`      | 是    | String      | 微信 APPID                                            |
| `app_id_list[].app_id_type` | 是    | String      | APPID 类型：`OFFICIAL_ACCOUNT`=公众号、`MINI_PROGRAM`=小程序  |
| `app_id_list[].app_secret`  | 否    | String      | appSecret，JSAPI 支付签名所需，公众号/小程序认证后必填，**请妥善保管，不得泄露**  |

## 响应参数

| 字段              | 是否必选 | 字段类型   | 字段说明                                                   |
| --------------- | ---- | ------ | ------------------------------------------------------ |
| `out_apply_no`  | 是    | String | 申请单号，原样返回                                              |
| `modify_code`   | 是    | String | 平台变更申请单号                                               |
| `modify_status` | 是    | String | 变更申请状态：`AUDITING`=审核中、`SUCCESS`=审核通过已生效、`REJECTED`=已驳回 |
| `timestamp`     | 是    | int64  | 提交时间，秒级时间戳                                             |

## 示例

**请求**

```json theme={null}
{
  "out_apply_no": "W20260815001",
  "merchant_code": "M202608150001",
  "app_id_list": [
    {
      "app_id": "wx1234567890abcdef",
      "app_id_type": "OFFICIAL_ACCOUNT",
      "app_secret": "d41d8cd98f00b204e9800998ecf8427e"
    }
  ]
}
```

**响应**

```json theme={null}
{
  "out_apply_no": "W20260815001",
  "modify_code": "MMA2026081500002",
  "modify_status": "AUDITING",
  "timestamp": 1755342000
}
```

## 审核流程

提交后进入审核：`AUDITING`（平台审核）→ `SUCCESS`（平台同步至微信商户平台完成关联后生效）或 `REJECTED`（驳回，附 `reject_reason`）。审核结果通过[变更状态查询](../merchant/modify-query)获取。

<Note>
  审核通过且商户认证状态（`auth_status`）为 `AUTHORIZED` 后，JSAPI 支付可正常交易；认证状态见[认证状态查询](../auth/apply-query)。
</Note>