集成指南
集成指南
集成指南
本文档提供 PayCools 标准接入流程的详细操作步骤，帮助商户顺利完成对接。
前置准备
1
商务洽谈
为高效推进合作，请与我方商务人员协同创建技术对接群，并邀请双方技术对接及相关负责人入群。
入群后请同步以下关键信息：
- 商户背景：包括所属行业、核心业务模式
- 对接产品：具体产品类型可与我方商务人员确认
2
环境信息
技术支持会将相关环境信息发送至技术对接群，请妥善保存。主要包含以下内容：
- API 接口域名：测试环境与生产环境的 API 地址
- 商户后台地址：测试环境与生产环境的管理后台登录地址
- 平台公钥：用于验证 PayCools 回传数据的签名
完整环境信息请参考 环境信息。
3
技术参数配置
使用测试账号登录商户后台，完成以下配置：
- 根据手机系统下载安装 Authenticator（若已安装可跳过）
- 用 Authenticator 扫描页面右方二维码绑定 MFA
- 查看 Authenticator 中的 MFA 码并输入即可
后续登录直接查看 MFA 码即可，无需再次绑定。如需重新绑定请联系技术支持进行重置。
登录商户后台后，进入 开发者 → 应用详情 完成以下配置：
- 公钥：自行生成并上传，注意不要有空格和换行。详细操作请参考 技术参数配置(公钥配置)
- Webhook：Payout 为代付产品的回调，如未集成代付产品可不配置。注意需使用 HTTPS 协议、正常域名，不要配置 IP + 端口形式
- IP 白名单：测试环境无需配置，线上环境请将 IP 发送给技术支持人员配置
技术集成
4
5
测试验证
集成开发完成后，请依次完成以下验证：
5.1
连通性测试
- 构造一个简单请求，验证网络连通性，确认签名验签、IP 白名单等基础配置是否正确
- 分别发起一笔成功交易和一笔失败交易，校验请求与响应是否符合预期
- 验证支付结果回调通知是否能够正常接收，回调数据是否完整，以及签名验签是否通过
5.2
UAT 验收测试：连通性测试通过后，请按照 UAT 验收标准进行完整测试，完成后将验收结果发送至技术支持群，后台会进行审核。验收标准请联系技术对接人员获取。
注意：提供申请测试账号的邮箱最好是技术人员邮箱，方便完成商户后台配置。
UAT 测试：请按照 UAT 验收表格进行测试并填写相关信息，完成后发送至技术支持群，后台会进行审核。验收表格请联系技术对接人员获取。
注意：提供申请测试账号的邮箱最好是技术人员邮箱，方便完成商户后台配置。
5.3
线上测试：UAT 审核完成后，进入线上测试阶段。技术支持会将线上域名等信息发送至邮箱。
使用线上商户账号密码登录 线上商户后台 完成配置，配置流程与测试环境相同。
注意：线上商户账号和测试环境商户账号不是同一个账号。如不知道线上商户账号密码信息，请联系技术支持。
5.4
在群里询问技术支持是否已完成费率及 IP 白名单配置。技术支持会在后台进行配置并反馈结果。
5.5
以上配置完成后即可开始线上测试。测试需将视频发送至技术对接群留存。
确认测试通过后，即顺利完成对接。