支付网关用于接收客户付款并核对账单结果。配置前准备自己的商户资料,先使用小额测试订单验证完整流程。
添加支付方式
- 打开后台 支付网关,点击添加。
- 选择当前版本提供的驱动,例如支付宝、微信、易支付、码支付或快跑云支付。
- 按驱动表单填写商户标识、凭据及其他必填项。
- 保存并启用,使用测试客户创建账单并支付。
- 核对平台交易记录、本站账单和交易流水。
驱动、插件及必填字段以当前站点实际列表为准。网关显示名称用于客户选择,不要在显示名称中填写密钥或内部连接地址。
快跑云支付与易支付类网关
使用对应驱动表单配置自己的商户资料,遵循所使用协议版本的要求,不能混用不同版本的密钥或通知配置。
填写配置时:
- 商户 ID、密钥等从自己的商户后台取得。
- 接口地址只用于管理端配置,客户侧使用清晰的支付方式名称。
- 通知与返回地址以本站生成结果为准,不复制其他站点的地址。
- 支付类型按驱动支持项选择,启用后检查前台是否显示预期渠道。
不要在公开文档、工单截图或页面脚本中放入商户凭据。
测试与排错
| 现象 | 检查 |
|---|---|
| 前台不显示渠道 | 网关是否启用、驱动是否可用、对应支付类型是否支持 |
| 跳转失败 | 商户资料、接口版本、服务可达性及 HTTPS |
| 已付款但账单未更新 | 服务端通知是否到达、网关日志及平台订单状态 |
| 金额或订单不一致 | 停止重复操作,核对双方交易记录后联系支付服务商 |
不能仅因浏览器跳回“成功”页面就手工认定已入账。不要为修复通知失败而关闭签名或金额校验。
插件支付驱动
先安装并启用 gateway 类型插件,再从支付驱动列表选择对应项;插件未包含在交付包时,需要单独取得。
扩展开发使用 app\common\lib\GatewayPlugin 和公开 GatewayInterface,实现配置字段、支付发起、通知验证及通知成功响应等约定。验签失败应报错,不得直接返回付款成功。
插件生命周期与目录格式见插件开发教程。
下一篇:实名认证