独角数卡接入蓝鲸支付教程
独角数卡的版本、主题和支付扩展可能存在差异。本页提供通用接入检查框架；实际字段名以你安装的蓝鲸支付适配插件及演示视频为准，避免照搬不匹配版本的配置。
一、接入前准备
- 蓝鲸支付账户或已完成的私有化环境。
- 后台可用的通讯密钥、微信码和支付宝码。
- 已能正常下单的独角数卡站点与 HTTPS 域名。
- 与你的独角数卡版本匹配的蓝鲸支付扩展或适配支付方式。
- 可用于联调的低价测试商品。
二、先验证蓝鲸支付本身
在接入独角数卡前，先用蓝鲸支付后台或接口文档创建测试订单，确认安卓监听在线、微信和支付宝到账可识别、支付后台订单能完成。这样可以把“支付环境问题”和“商城插件问题”分开排查。
三、安装或启用支付扩展
在独角数卡管理后台找到支付方式或插件管理，安装与你当前版本兼容的蓝鲸支付适配扩展，并启用微信、支付宝中需要的渠道。若插件来自第三方，请先核验来源、代码和更新记录。
不要把蓝鲸支付通讯密钥填写到不可信插件，也不要在前端页面或公开仓库中暴露密钥。
四、配置参数对应关系
| 独角数卡配置含义 | 蓝鲸支付对应值 |
|---|---|
| 网关/接口地址 | 你的蓝鲸支付商户域名，创建订单路径为 /createOrder |
| 商户密钥/API Key | 后台“通讯密钥” |
| 支付类型 | 微信 1，支付宝 2 |
| 订单号 | 映射为 payId，必须唯一 |
| 附加参数 | 可映射为 param，并在回调中原样返回 |
插件若要求商户号、应用 ID 等蓝鲸接口本身不存在的字段，应以适配插件说明为准，不要随意填写。
五、回调处理要求
适配插件应接收蓝鲸支付 GET 通知，使用下式验签，并在独角数卡订单更新成功后输出纯文本 success：
md5(payId + param + type + price + reallyPrice + 通讯密钥)
回调地址必须可公网访问，不能被登录验证、CDN 规则或防火墙拦截。独角数卡订单更新必须幂等，避免重复发卡。
六、测试步骤
- 创建一件低价、库存独立的测试商品。
- 选择微信下单，核对独角数卡订单号与蓝鲸
payId。 - 按支付页显示的实际金额付款。
- 检查蓝鲸后台订单、回调响应和独角数卡发卡结果。
- 支付宝重复一次，再测试重复刷新和重复通知。
七、常见问题
- 支付页打不开：检查接口域名、HTTPS 和插件生成的请求地址。
- 提示签名错误：检查字段顺序、空
param、金额格式和通讯密钥。 - 蓝鲸已完成但未发卡：检查通知地址、响应是否为
success、商城任务与库存。 - 重复发卡：检查插件是否按独角数卡订单号幂等更新。
八、查看现有演示
站点已提供独角数卡接入演示视频，可结合你的版本逐项核对后台字段。