接入相关
如何获得 app_key 和 app_secret?
渠道商在星富通管理后台完成入驻后,由平台分配app_key 与 app_secret。请妥善保管 app_secret,不要以明文形式出现在代码仓库、日志或聊天记录中。
接口域名是什么?
https://gw.xft.xin/openapi,接口路径见各接口文档的「请求地址」。
签名总是失败,常见原因有哪些?
- 时间戳与平台时间差超过 5 分钟(请校准服务器时间);
- 签名原文中的 URL 不是完整地址(应包含
https://gw.xft.xin与路径); - 请求体与签名时的 body 不一致(请对发送的原始字节签名);
app_secret配错或带有多余空格/换行。
进件相关
小微商户进件要传什么材料?
小微商户(type=5)无需营业执照:license_no 可不填,不传营业执照图片(category=1),改传统一社会信用代码证书(category=22);商户名称按「商户_XXX」规范填写。结算账户图片(银行卡等)按结算主体要求上传。
reuse_legal_person 怎么用?
联系人复用法人信息时,将reuse_legal_person 置为 true,联系人姓名、证件号码及联系人证件照(category=4/5)可不填,平台自动取法人信息。
图片类型传错了怎么办?
图片上传后key 7 天有效,进件提交前可重新上传正确类型的图片,进件提交时引用正确的 key 即可。若进件已提交且被驳回,可重新上传图片后通过商户进件提交重新提交重提。
提交后如何知道审核结果?
平台仅对终态(SUCCESS/REJECTED)发送审核异步通知到back_url;中间态(AUDITING/PROCESSING)可通过进件状态查询主动查询。
通知没收到怎么办?
平台按 1min/5min/30min/2h/6h 指数退避重试最多 5 次。若仍未收到,请通过进件状态查询确认终态,并以查询结果为准;多次重试失败的通知会落库,可联系平台人工补发。重复提交进件会怎么样?
同一out_apply_no 重复提交不会创建新申请单,接口返回 HTTP 200 与当前申请单状态(幂等语义),不报错。
进件被驳回后如何重新提交?
重新调用商户进件提交接口:同out_apply_no + 完整进件资料(含修改后的字段),平台以本次提交覆盖原申请单,重新进入待审核。

