Skip to main content

接入相关

如何获得 app_key 和 app_secret?

渠道商在星富通管理后台完成入驻后,由平台分配 app_keyapp_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 置为 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 + 完整进件资料(含修改后的字段),平台以本次提交覆盖原申请单,重新进入待审核。

认证相关

认证申请后多久有结果?

认证为扫码流程,需商户扫码后由微信/支付宝侧完成认证,认证状态查询接口返回认证状态。中间状态与最终结果均以认证状态查询为准。