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

# 版本说明

## 版本约定

* 文档版本随接口演进更新；接口以文档为准，不另行通知。
* 错误码、状态机、产品码的调整会在[附录](../appendix/return-code)中同步维护。
* 接口路径一经发布保持稳定，新增能力通过新增接口或字段提供，不影响既有对接。

## 版本记录

### v1.0.0（一期，2026-08-15）

**开放范围**

* 商户进件类接口 4 个：图片上传、商户进件提交、进件状态查询、商户状态查询；
* 商户变更类接口 2 个：商户信息变更、变更状态查询（变更经平台审核，通过后生效）；
* 微信支付宝认证配置接口 3 个：认证申请、认证状态查询、子商户信息查询；
* 微信商户配置接口 2 个：微信商户新增APPID、微信商户新增授权目录（经平台审核，通过后同步至微信商户平台）；
* 审核异步通知（进件终态结果回调 `back_url`）。

**协议**

* 采用 app\_key 对称签名机制（HMAC-SHA256），详见[签名验签说明](../spec/signature)。

**已知约定**

* 进件重复提交（同 `out_apply_no`）幂等返回原申请单当前状态，不报错；
* 通知仅终态下发，中间态（AUDITING/PROCESSING）以[进件状态查询](../merchant/apply-query)为准；
* 接口域名 `https://gw.xft.xin/openapi`。

<Note>
  一期为人工审核模式：进件提交后由平台审核人员审核，审核结果通过异步通知 + 查询接口获取。
</Note>