关闭这份接入进度?

进度是整个接入方共用的
同一个接入方下的其他成员看到的也是这一份。你关掉之后, 他们再登录看到的是空白进度,需要重新走一遍向导。
登录
注册
进度按接入方保存,换设备或换人登录都能接着做。
0%
接口 0 / 0

接入完成

接入助手 规则版 ×
结论来自诊断器、沙箱与进度引擎,每条事实陈述都会附依据; 给不出依据时它会直接说判定不了,不猜。写操作只提议,需你确认才执行。

API 自助接入平台

回答几个问题,我们为你生成专属的接入方案 —— 该用哪套接口、需要做哪几步、 第一段代码怎么写。过程中遇到报错,把报文贴进来,我们直接告诉你哪里错、改成什么。

收单支付 发卡 钱包网络 令牌服务
01
不用先读完文档
我们只给你这次接入用得到的那部分,其余的不打扰你。
02
报错自己就能定位
粘贴报文,得到确定结论和修正后的报文,而不是"可能是签名问题"。
03
自己验证,不必等人
在沙箱里改完就能重放,跑通了才算这一步完成。
API 自助接入平台
返回首页

你是哪一类接入方?

不同接入方对应不同的 API 体系,先分流能省掉大量无关内容。

API 自助接入平台
返回首页

你要接入哪条业务线?

我们对外有多套独立的 API 体系,认证方式与接口风格各不相同。

API 自助接入平台
返回首页

你的场景与接入方式

API 自助接入平台
返回首页
原型占位

这条业务线的接入内容尚未整理进平台。此屏是留给我们自己填的坑位。

需要补充的内容
  • 业务场景划分(对应「收单支付」里的线上 / 线下)
  • 接入方式与投入梯度(对应 Drop-in / LinkPay / API)
  • 可选能力清单
  • OpenAPI 规范、错误码表、签名与加密规范
  • 资质门槛(哪些能力需要什么资质)
  • 沙箱环境与可运行代码样例
平台的引擎与这些内容是分离的 —— 补齐上面这些资料,这条业务线即可获得 与「收单支付」完全相同的诊断、向导、自查能力,无需改代码。
API 自助接入平台
返回首页

这次接入需要哪些能力?

可多选,也可以先不选。后面随时能加 —— 加了之后清单和代码会自动更新。

API 自助接入平台
返回首页

开发语言与接入前准备

先选语言,我们据此给代码。下面是开始调试前需要备齐的数据 —— 现在不用填,先知道要凑什么、找谁要。

开发语言 必选
决定代码样例与签名工具类的语言。

接入前数据准备

友情提示
开始对接前,下面这些需要先在你侧备齐,每项都写了从哪儿来。 其中标识类参数(参与方标识、商户号)在商务阶段就已谈定,平台不分配, 去接入协议里核对即可。本页只作提醒,不需要填写。
API 自助接入平台
重新开始

你的接入方案已生成

下面这些内容只针对你的选择,没有多余的部分。

以下清单与代码均由上面这些选择推导。改动任一项,清单会同步变化。

开始调试前需备齐

接入清单 · 共 0

第一段代码


      
    
API 自助接入平台
返回方案

接入工作台

向导只走一次,这里是你接下来的主场。它记得你走到哪一步。

接口与案例
贴入诊断 实时
怎么用这一页

方案页给的代码只是参考 —— 我们不知道你的核心代码与数据结构,不去猜。 那段 demo 只说明「怎么调我们」,真正的实现由你写。
写好之后按下面的案例用你自己的代码发起请求。 结果不对就切到「贴入诊断」,把报文与应答贴进来拿结论。 一条条勾掉,某个接口的案例全勾完,这个接口就完成了。

贴入非预期的请求或应答 实时诊断

你用自己的代码发出去、结果不对的那一笔,把它贴到这里。我们给确定结论, 不给"可能是…",每条结论带修正方案与文档依据。
首行是 METHOD /path,空行之后是 body;应答可以接在后面一起贴。

内部视图(面向我方集成支持与文档维护):文档体检与卡点统计 →
API 自助接入平台 · 内部视图
返回工作台

文档体检与卡点统计

这一屏不面向对接方。它回答两个问题:文档哪里有问题、对接方都卡在哪 —— 改文档是提升自助率最便宜的手段。

关键指标

6.5 天
平均接入周期
阶段⑤ − 阶段①(联调走完)
68%
自助率
全程无人工介入走完五个阶段
73%
诊断有效率
诊断后下一次沙箱请求成功
1.8
工单 / 单接入方
接入期内
数值为示意。口径定义见 REQUIREMENTS.md §3.2

文档一致性缺陷

真实缺陷 占位符泄漏 · 真实 sid 硬编码进 spec
.../merchant-api/apis/reference/tag/Payment/g2_v1_payment_mer_S005580_evo.e-commerce.payment/post —— 路径中 S005580 是真实商户号,同类路径其余均为 {sid}
真实缺陷 中英不对等 · 多条 URL 缺中文版
Gateway Offline 的 DCCToNon-DCC 两个操作、若干 Notification/*_webhook 仅有 en-us,无对应中文页。
真实缺陷 重复页 · 同一码表两个入口
/gateway/developer-portal/response-code/gateway/developer-portal/appendix/response-code 并存,且前者缺语言对。
以上三条是实际抓取 sitemap 发现的真实缺陷,非构造样例,见 README.md §9.4。检测本身是结构化查询,不需要模型参与。

对接方卡点分布

阶段③ 41% 签名验不过 —— signBase 拼装顺序理解错 · 建议在签名规范页加可运行样例
阶段③ 18% 金额最小单位 —— 零小数币种带小数点 · 建议币种表标注小数位
阶段④ 15% webhook 收不到 —— 回调地址未登记或你侧防火墙拦截,表现为超时 · 建议准备清单前置提示
阶段⑤ 12% 错误码只有含义没有处置建议 · 建议码表补「该怎么办」列
阶段① 8% 选型困难 —— 四种接入方式差异不清 · 建议加投入梯度对照
分布为示意。真实实现取自诊断与沙箱的失败留痕,不依赖问卷。 每一条都对应一个可执行的文档改进动作 —— 这是把自助率往上推的闭环。