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

# 微信商户新增授权目录

## 功能说明

JSAPI 支付发起页面所在的域名，须配置到微信商户平台的**支付授权目录**下，否则商户在支付页面拉起微信收银时提示「当前页面的URL未注册」。本接口供渠道商为已进件商户提交支付授权目录配置申请，平台审核通过后同步至微信商户平台生效。

* 配置申请由平台审核，**审核通过后同步生效**，无需渠道商登录微信商户平台操作；
* 授权目录按支付发起域名配置，须精确到支付发起页面的完整目录（如 `https://pay.example.com/`），同一域名下多个支付入口可分别配置；
* H5 支付（`WECHAT_MWEB`）走域名校验，不在此配置；
* 驳回后重新提交（同 `out_apply_no` 覆盖重提）。

## 请求地址

`POST https://gw.xft.xin/openapi/v1/merchant/wechat/jsapi-path`

## 请求参数

| 字段              | 是否必选 | 字段类型        | 字段说明                                                |
| --------------- | ---- | ----------- | --------------------------------------------------- |
| `out_apply_no`  | 是    | String(≤64) | 申请单号，业务幂等键，同一渠道商下唯一                                 |
| `merchant_code` | 是    | String      | 平台商户号，进件成功后在通知与[进件状态查询](../merchant/apply-query)中下发 |
| `jsapi_paths`   | 是    | Array       | 支付授权目录 URL 列表，配置全量提交（不含已配置项视为删除）                    |

## 响应参数

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

## 示例

**请求**

```json theme={null}
{
  "out_apply_no": "D20260815001",
  "merchant_code": "M202608150001",
  "jsapi_paths": [
    "https://pay.example.com/",
    "https://pay.example.com/mall/"
  ]
}
```

**响应**

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

## 审核流程

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

<Note>
  支付发起域名须已 ICP 备案，且与支付页面实际使用域名一致；授权目录未配置时，JSAPI 支付拉起微信收银会提示「当前页面的URL未注册」。
</Note>