> ## 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 和 app\_secret？

渠道商在星富通管理后台完成入驻后，由平台分配 `app_key` 与 `app_secret`。请妥善保管 `app_secret`，**不要以明文形式**出现在代码仓库、日志或聊天记录中。

### 接口域名是什么？

`https://gw.xft.xin/openapi`，接口路径见各接口文档的「请求地址」。

### 签名总是失败，常见原因有哪些？

* 时间戳与平台时间差超过 5 分钟（请校准服务器时间）；
* 签名原文中的 URL 不是完整地址（应包含 `https://gw.xft.xin` 与路径）；
* 请求体与签名时的 body 不一致（请对发送的原始字节签名）；
* `app_secret` 配错或带有多余空格/换行。

详见[签名验签说明](./spec/signature)。

## 进件相关

### 小微商户进件要传什么材料？

小微商户（`type=5`）无需营业执照：`license_no` 可不填，不传营业执照图片（category=1），改传统一社会信用代码证书（category=22）；商户名称按「商户\_XXX」规范填写。结算账户图片（银行卡等）按结算主体要求上传。

### reuse\_legal\_person 怎么用？

联系人复用法人信息时，将 `reuse_legal_person` 置为 `true`，联系人姓名、证件号码及联系人证件照（category=4/5）可不填，平台自动取法人信息。

### 图片类型传错了怎么办？

图片上传后 `key` 7 天有效，进件提交前可重新上传正确类型的图片，进件提交时引用正确的 `key` 即可。若进件已提交且被驳回，可重新上传图片后通过[商户进件提交](./merchant/apply-create)重新提交重提。

### 提交后如何知道审核结果？

平台仅对终态（SUCCESS/REJECTED）发送[审核异步通知](./merchant/apply-notify)到 `back_url`；中间态（AUDITING/PROCESSING）可通过[进件状态查询](./merchant/apply-query)主动查询。

### 通知没收到怎么办？

平台按 1min/5min/30min/2h/6h 指数退避重试最多 5 次。若仍未收到，请通过[进件状态查询](./merchant/apply-query)确认终态，并以查询结果为准；多次重试失败的通知会落库，可联系平台人工补发。

### 重复提交进件会怎么样？

同一 `out_apply_no` 重复提交不会创建新申请单，接口返回 HTTP 200 与当前申请单状态（幂等语义），不报错。

### 进件被驳回后如何重新提交？

重新调用[商户进件提交](./merchant/apply-create)接口：同 `out_apply_no` + 完整进件资料（含修改后的字段），平台以本次提交覆盖原申请单，重新进入待审核。

## 认证相关

### 认证申请后多久有结果？

认证为扫码流程，需商户扫码后由微信/支付宝侧完成认证，认证状态查询接口返回认证状态。中间状态与最终结果均以[认证状态查询](./auth/apply-query)为准。