NODE.JS SDK · MIT

一个包,支持 JavaScript 和 TypeScript。

为 Node.js 后端添加 Wholly Crypto 支付。内置类型定义,支持 ES modules 和 CommonJS,无需单独的 TypeScript 包。

使用 npm 安装

需要 Node.js 22+。用于服务器,不用于浏览器代码。

npm install whollycrypto

使用带类型的请求开发

  • 创建账单并向客户返回结账 URL
  • 读取付款状态、商店和接受的资产
  • 在后端验证签名付款通知
  • JavaScript 或 TypeScript 使用同一个包

密钥保留在你的后端。

使用自己的安装的 API URL 和限定项目的 API 凭据。从“商店 → 基本设置”复制项目/商店 API ID。绝不要把 API 密钥或签名密钥放进前端打包文件。

在解析 JSON 前保留原始请求体用于签名验证。IPN 使用商店 IPN 密钥;Webhook 使用各自端点的密钥。履行订单前检查结算状态。

API 参考 → · IPN 与 Webhook → · 所有 SDK →

自动管理你的运营商安装。

SDK 2.6.0 新增独立的 OperatorClient ,适用于 Wholly Crypto 7.4.0+:直接或邀请商户入驻,管理用户、商店、本地额度,以及带签名的生命周期 Webhook。

API 权限与设置 → · JavaScript / TypeScript 运营商示例 →