01
提交接入需求
说明业务方向、预计调用规模与期望上线时间，同时填写对接负责人与联系方式。资料齐全后，我们会给出初步的接入建议与所需准备清单。
五个环节，按顺序推进即可
每个环节都有独立的确认节点，上一环节确认完成后才进入下一环节。遇到需要调整的情况，可以在当前节点内处理，不必整体回退。
02
主体与配置核对
核对主体登记信息、调用场景与安全设置，确认需要开放的接口范围。测试环境与生产环境的参数分别配置，避免上线时临时补配置。
03
沙箱环境联调
使用测试参数完成主要调用链路，逐项核对请求结构、返回字段与异常分支。联调记录同步留档，便于后续排查与版本追溯。
04
验收确认与灰度上线
按验收清单逐项确认，先选择一条低风险业务线小流量验证，观察关键指标稳定后再逐步提高占比，最终完成全量切换。
05
运行支持与持续优化
上线后按周期回顾调用情况与关键指标，依据实际业务变化调整参数与容量配置。遇到问题可通过帮助中心或对接渠道获取支持。
三种接入方式，按团队情况选择
不同团队的技术储备与维护习惯不一样，可以从开发工作量、参数可控性与后续维护方式三个角度做取舍。
| 对比项 | 接口直连 | SDK 集成 | 托管配置 |
|---|---|---|---|
| 预计接入耗时 | 约 3～5 个工作日 | 约 2～4 个工作日 | 约 1～2 个工作日 |
| 开发工作量 | 需自行处理签名与重试 | 调用封装方法即可 | 无需额外开发 |
| 参数可控性 | 完全可控，可精细调整 | 较高，支持常用配置项 | 按预设选项调整 |
| 适合团队 | 有稳定后端研发力量 | 希望快速上线并保留调整空间 | 以业务使用为主、研发资源有限 |
| 后续维护方式 | 随版本升级自行适配 | 跟随 SDK 版本更新 | 由配置面板统一管理 |
如果难以判断，可以在提交需求时说明当前系统情况，我们会给出适配建议。
这些情况适合按本流程推进
无论是首次对接，还是在现有系统上扩展新的调用场景，都可以沿用同一套步骤。
首次接入，需要明确节奏
团队第一次接触 PG官网 的能力，希望知道每一步要准备什么、由谁确认、大概花多长时间。
- 从需求登记开始，按环节推进
- 每个节点都有确认动作
系统改造，需要控制影响
已有业务系统正在运行，新增调用不能影响原有链路，需要沙箱验证与灰度过渡。
- 测试环境先行验证
- 分批灰度，可按需回退
业务增长，需要调整容量
调用量随业务上升，原有参数配置需要重新评估，希望在变更时保留观察窗口。
- 按实际用量调整配置
- 变更后关注关键指标
上线前需要逐项确认
验收环节不追求一次通过，而是把每个要点确认清楚，避免上线后才发现需要返工。以下条目为常见确认项，可按实际接入范围增减。
- 环境与参数
- 测试环境与生产环境的参数已分别配置并核对，密钥按规范保管，未出现在代码仓库或日志中。
- 调用链路
- 主要业务链路均已在测试环境跑通，返回字段与业务侧解析逻辑一致，字段缺失情况已有兜底处理。
- 异常处理
- 超时、限流与参数错误等分支已确认处理方式，重试策略与告警阈值已设置。
- 灰度安排
- 灰度业务线、流量占比与观察时长已明确，回退操作步骤已提前演练。
- 对接方式
- 双方对接负责人与联系渠道已确认，问题反馈与处理记录的留存方式已约定。
- 上线时间
- 切换时间安排在业务低峰期，观察窗口内有人值守，可及时响应异常。
接入常见问题
关于准备材料、联调时间、上线调整与问题排查，这里整理了最常被问到的内容。
接入 PG官网 需要准备哪些材料？
通常需要主体登记信息、对接负责人联系方式、拟使用的调用场景说明，以及测试与生产两套环境的配置清单。材料齐备后再进入参数配置环节，可以避免反复确认。
沙箱联调一般需要多长时间？
接口数量较少、参数结构清晰的场景，通常三到五个工作日可以完成主要调用链路的联调；涉及多个业务系统或需要改造既有代码时，时间会相应延长，建议在需求登记时一并说明。
上线之后还能调整参数配置吗？
可以。参数与容量配置支持在运行期间按需调整，建议在业务低峰期变更，并在变更后观察一段时间的关键指标，确认无异常再继续扩大范围。
调用出现异常时应该怎么排查？
先核对请求参数与签名是否符合文档说明，再对照返回码定位问题环节。如果确认是配置或环境问题，可携带时间点与请求标识联系支持人员协助定位。
是否支持分批灰度上线？
支持。常见做法是先选择一条低风险业务线做小流量验证，观察指标稳定后再逐步提高占比，最终完成全量切换，整个过程可按需回退。
接入过程中由谁负责跟进？
建议在双方各指定一名对接负责人，负责推进节点、确认交付物与汇总问题。日常沟通集中在对接群或工单中，便于后续复盘与查阅记录。
接入需求登记
信息仅用于本次接入沟通，提交后会有对接人员与你联系确认细节。