NODE.JS SDK · MIT

One package. JavaScript and TypeScript.

Add Wholly Crypto payments to your Node.js backend. Built-in types, ES modules and CommonJS, without a separate TypeScript package.

Install with npm

Requires Node.js 22+. Use on the server, not in browser code.

npm install whollycrypto

Build with typed requests

  • Create invoices and return checkout URLs to customers
  • Read payment status, stores and accepted assets
  • Verify signed payment notifications on your backend
  • Use the same package from JavaScript or TypeScript

Your backend holds the keys.

Use the API URL of your own installation and a project-restricted API credential. Copy Project/Store API IDs from Store → Basic. Never put API keys or signing secrets in frontend bundles.

Keep the raw request body for signature verification before JSON parsing. IPN uses the store IPN secret; webhooks use their own endpoint secrets. Check settlement before fulfilling an order.

API reference → · IPN & webhooks → · All SDKs →