异次元发卡对接易支付配置教程

异次元发卡通过「支付插件」接入易支付:先在插件里填好泡泡支付的网关和密钥,再到「支付接口」里添加支付宝、微信两个收款方式。

  • 异次元发卡
  • 易支付插件
  • 易支付 V1
  • 更新于

准备工作

开始前先联系官方客服开通接入应用,拿到下面三样。三个系统用的都是这同一组参数。

参数说明
网关域名客服提供的支付网关,如 https://网关域名
商户 ID(pid)接入应用的商户 ID
商户密钥(key)接入应用的密钥,用于 MD5 签名,不要外泄

配置易支付插件

  1. 后台打开「支付管理」→「支付插件」,找到易支付插件。列表里没有的话,点「安装更多插件」到应用商店安装。
  2. 点该插件的「配置」,按下表填写并保存。
插件配置填什么
接口地址https://网关域名,填到域名即可,程序会自动拼上 /submit.php
商户 IDpid
商户密钥key

易支付插件由应用商店提供,不同版本里输入框的名称可能略有差别,按含义对应即可。

添加支付接口

打开「支付管理」→「支付接口」,点「添加支付」,按下表填写。

字段填什么
支付名称展示给买家的名字,如「支付宝」
支付插件选上一步配置好的易支付插件
支付配置选上一步保存的那份配置
支付方式选支付宝或微信;列表里没有就在「自定义Code」里填 alipay 或 wxpay
显示终端通用
商品下单 / 会员充值按需要开启

支付宝和微信各添加一条,除了「支付名称」和「支付方式」,其余相同。

下单测试

  1. 在前台挑一个低价商品下单,选择刚添加的支付方式。
  2. 页面应跳到收银台,完成支付。
  3. 回到订单页能看到卡密,后台订单变为已支付,说明配置成功。

常见问题

现象原因与处理
跳转后提示「验签失败」插件里的商户密钥填错或带了空格,重新复制 key 保存
接入应用未配置支付方式 xxx 对应的产品这个支付方式还没开通,或支付方式编码写错了(微信是 wxpay,不是 wechat)。编码无误就联系官方客服配置
支付成功但没有发货异步通知没到。异次元发卡的回调地址形如 https://你的域名/user/api/order/callback.插件标识,确认它能被公网访问、没有被防火墙或 CDN 拦截
开启回调 IP 白名单后收不到通知如果你在后台开启了回调 IP 白名单,需要把泡泡支付的通知服务器 IP 加进去,IP 请向官方客服索取

其他报错见 排错指引;协议细节见 签名算法 与 异步通知。

其他对接文档

获取商户 ID 与密钥

联系官方客服开通接入应用,网关地址、pid 与 key 由客服直接提供,专人协助联调。

联系官方客服