ColawallexPay

ColawallexPay 支付 SDK 前端插件，帮助商户快速集成信用卡支付。

支持两种支付模式：

• 直接跳转 — 提供 casher_link，在新窗口打开支付页面
• 弹窗表单 — 弹出对话框，用户填写卡号/有效期/CVV，校验后自动提交

安装

CDN

<script src="https://wallexpay.oss-cn-hangzhou.aliyuncs.com/public/colawallexpay.min.js"></script>

npm

npm install colawallexpay

使用

浏览器（CDN）

const pay = new ColawallexPay({
  casher_link: '',         // 可选：支付跳转链接
  gateway: 'https://...',  // 必填：支付网关 URL
  data: '...',             // 必填：加密支付数据（后端返回）
  payment_id: '...',       // 必填：系统订单号
  onErr: function(code, msg) {
    console.log(code, msg)
  }
})

pay.createFormPayment_v1()

Node.js / Webpack

import ColawallexPay from 'colawallexpay'

const pay = new ColawallexPay({ /* ... */ })
pay.createFormPayment_v1()

API

new ColawallexPay(options)

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | casher_link | string | 否 | 支付跳转 URL。提供则 window.open；不提供则弹出表单 | | gateway | string | 是* | 支付网关地址（表单提交目标） | | data | string | 是* | 加密支付数据，作为隐藏字段提交 | | payment_id | string | 是* | 系统订单号 | | onErr | function(code, msg) | 否 | 错误回调函数 |

* 当未提供 casher_link 时，gateway、data、payment_id 为必填。

colawallexPay.createFormPayment_v1()

启动支付流程：

• 有 casher_link → 直接打开链接
• 无 casher_link → 弹出信用卡填写表单

colawallexPay.on(event, fn)

注册事件监听器，支持链式调用。

pay.on('error', function(code, msg) {
  // 处理错误
})

colawallexPay.emit(event, ...args)

手动触发事件。

错误码

| 错误码 | 含义 | |--------|------| | LACK_PARAM | 缺少必要参数 |

注意事项

• 确保使用的是最新版本，可通过 npm view colawallexpay version 检查
• CDN 引入时，ColawallexPay 是全局变量；npm 引入时请使用 import 或 require()
• 同一页面多次 new ColawallexPay() 不会重复注入 CSS

License

MIT