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

# 阅读对象

## 平台简介

星惠付开放平台（以下简称「开放平台」）向渠道商（服务商）及旗下品牌开放**商户录入与进件**、**进件进度与签约查询**、**微信/支付宝认证配置**能力。渠道商/品牌通过开放平台接口将商户录入平台并指定支付机构与产品费率，平台审核通过后按渠道商配置发起机构进件，进件完成后商户即可使用扫码支付等收单能力。

开放平台接口统一通过网关接入，采用 app\_key 签名机制保证请求来源可信与防重放，详见[签名验签说明](https://opendocs.xft.xin/open/ledger/spec/signature.md)。

## 阅读对象

本系列文档面向以下人员：

| 角色 | 阅读内容 |
| - | - |
| 渠道商/品牌技术人员 | 接口规范、各业务接口文档、附录，负责接口对接与联调 |
| 渠道商/品牌业务人员 | 业务指引（录入与进件流程、结算说明）、FAQ |
| 平台运维人员 | 接口规范、返回码说明，用于问题排查 |

## 文档结构

| 章节 | 内容 |
| - | - |
| 总体介绍 | 阅读对象、名词解释、版本说明 |
| 接口规范 | 接口格式定义、签名验签说明、参数说明 |
| 业务指引 | 商户录入与进件流程指引、结算周期及手续费说明 |
| 商户进件接口 | 图片上传、商户录入、进件状态查询、商户状态查询、签约信息查询、审核异步通知 |
| 微信支付宝认证配置 | 认证申请、认证结果查询、子商户信息查询、撤销认证 |
| 机构查询类接口 | 银联报备查询、机构信息查询 |
| 附录 | 返回码说明、产品清单、支付机构列表、状态机说明、枚举值说明 |
| FAQ | 常见问题 |

## 接入前置条件

渠道商/品牌接入开放平台前，需满足：

1. 渠道商在星惠付管理后台完成入驻（品牌需归属渠道商）；
2. 开通后获得签名凭据 `app_key` 与 `app_secret`（见[签名验签说明](https://opendocs.xft.xin/open/ledger/spec/signature.md)）。

> [!NOTE]
>
> 接口域名：
>
> * 测试环境：`https://go-test.xft.xin`
> * 生产环境：`https://gw.xft.xin`
>
> 所有接口路径以 `/openapi` 开头，完整请求地址示例：`https://gw.xft.xin/openapi/v1/merchant/add`。


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