准备工作
开始前先联系官方客服开通接入应用,拿到下面三样。三个系统用的都是这同一组参数。
| 参数 | 说明 |
|---|---|
| 网关域名 | 客服提供的支付网关,如 https://网关域名 |
商户 ID(pid) | 接入应用的商户 ID |
商户密钥(key) | 接入应用的密钥,用于 MD5 签名,不要外泄 |
配置易支付插件
- 后台打开「支付管理」→「支付插件」,找到易支付插件。列表里没有的话,点「安装更多插件」到应用商店安装。
- 点该插件的「配置」,按下表填写并保存。
| 插件配置 | 填什么 |
|---|---|
| 接口地址 | https://网关域名,填到域名即可,程序会自动拼上 /submit.php |
| 商户 ID | pid |
| 商户密钥 | key |
易支付插件由应用商店提供,不同版本里输入框的名称可能略有差别,按含义对应即可。
添加支付接口
打开「支付管理」→「支付接口」,点「添加支付」,按下表填写。
| 字段 | 填什么 |
|---|---|
| 支付名称 | 展示给买家的名字,如「支付宝」 |
| 支付插件 | 选上一步配置好的易支付插件 |
| 支付配置 | 选上一步保存的那份配置 |
| 支付方式 | 选支付宝或微信;列表里没有就在「自定义Code」里填 alipay 或 wxpay |
| 显示终端 | 通用 |
| 商品下单 / 会员充值 | 按需要开启 |
支付宝和微信各添加一条,除了「支付名称」和「支付方式」,其余相同。
下单测试
- 在前台挑一个低价商品下单,选择刚添加的支付方式。
- 页面应跳到收银台,完成支付。
- 回到订单页能看到卡密,后台订单变为已支付,说明配置成功。
常见问题
| 现象 | 原因与处理 |
|---|---|
| 跳转后提示「验签失败」 | 插件里的商户密钥填错或带了空格,重新复制 key 保存 |
| 接入应用未配置支付方式 xxx 对应的产品 | 这个支付方式还没开通,或支付方式编码写错了(微信是 wxpay,不是 wechat)。编码无误就联系官方客服配置 |
| 支付成功但没有发货 | 异步通知没到。异次元发卡的回调地址形如 https://你的域名/user/api/order/callback.插件标识,确认它能被公网访问、没有被防火墙或 CDN 拦截 |
| 开启回调 IP 白名单后收不到通知 | 如果你在后台开启了回调 IP 白名单,需要把泡泡支付的通知服务器 IP 加进去,IP 请向官方客服索取 |
其他对接文档
获取商户 ID 与密钥
联系官方客服开通接入应用,网关地址、pid 与 key 由客服直接提供,专人协助联调。
联系官方客服