NODE.JS SDK · MIT

1 つのパッケージで 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 運営者向けサンプル →