异次元店铺接入蓝鲸支付教程
异次元店铺不同版本或扩展的配置界面可能不同。本教程说明稳定不变的接口关系和联调方法，具体字段名请以已安装适配扩展及官方演示为准。
一、准备工作
- 确认异次元店铺本身可以正常创建订单和交付商品。
- 准备蓝鲸支付商户域名、通讯密钥和后台登录权限。
- 配置微信、支付宝无金额收款码及安卓监听端。
- 准备 HTTPS 公网域名，确保回调路由不需要登录。
- 备份店铺配置和数据库后再安装支付扩展。
二、独立验证支付环境
先在蓝鲸支付侧完成一笔微信和一笔支付宝小额测试，确认订单能被安卓监听识别并进入完成状态。若这一阶段失败，应先修复监听或收款码问题，不要在店铺插件中反复改参数。
三、启用适配支付通道
在异次元店铺后台的支付设置中，安装或启用与你当前版本兼容的蓝鲸支付通道。通道应能把店铺订单映射为蓝鲸 payId，并支持微信 type=1 与支付宝 type=2。
仅使用可信来源且与你的店铺版本匹配的扩展。安装前检查是否会记录或外传通讯密钥。
四、填写关键配置
| 配置含义 | 填写内容 |
|---|---|
| 接口/网关地址 | 蓝鲸支付商户域名，订单接口为 /createOrder |
| 通讯密钥 | 蓝鲸后台“系统设置”中的 key |
| 微信渠道 | 支付类型 1 |
| 支付宝渠道 | 支付类型 2 |
| 异步通知 | 扩展提供的异次元店铺回调 URL |
| 同步返回 | 支付完成后的订单结果页 |
五、确认签名与通知约定
创建订单签名：
md5(payId + param + type + price + 通讯密钥)
异步回调验签：
md5(payId + param + type + price + reallyPrice + 通讯密钥)
店铺处理成功后必须返回纯文本小写 success。扩展还应校验订单未完成、金额一致，并保证重复通知不会重复交付。
六、端到端测试
- 创建低价测试商品并记录店铺订单号。
- 选择微信支付，检查支付页显示的实际金额。
- 付款后核对安卓监听、蓝鲸后台和店铺订单三个状态。
- 确认自动交付只执行一次，刷新支付页不重复处理。
- 使用支付宝重复测试，并验证订单超时后的表现。
七、常见故障
- 创建订单失败：检查接口地址、支付类型、金额格式和创建签名。
- 二维码正常但不确认：检查到账通知、监听端在线状态和实际金额。
- 蓝鲸通知失败：检查店铺回调可达性、验签和
success响应。 - 支付后没有交付：检查店铺订单状态机、库存、定时任务和插件日志。
八、参考演示视频
可结合现有异次元店铺接入演示，按你使用的版本核对页面位置和字段名称。