PYTHON SDK · MIT

Crypto payments, in Python.

A lightweight client for your backend or scripts. Talk to your Wholly Crypto installation without adding runtime dependencies.

Install with pip

Requires Python 3.10+. Use a virtual environment for your application.

python -m pip install whollycrypto

From invoice to payment

  • Create invoices and retrieve checkout URLs
  • Read invoice status and available payment assets
  • Verify signed IPN and webhook requests
  • Use idempotency keys when retrying invoice creation

Use your own API.

Connect with your installation’s API URL and a project-restricted API credential. Find Project/Store API IDs in Store → Basic. Keep credentials in server-side configuration.

Verify notifications using the unmodified body and the correct secret: the store’s IPN secret or the individual webhook endpoint’s secret. Check invoice settlement before fulfilling an order.

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

Automate your Operator installation.

SDK 2.6.0 adds a separate OperatorClient for Wholly Crypto 7.4.0+: direct or invited merchant onboarding, users, stores, local credits and signed lifecycle webhooks.

API permissions and setup → · Python Operator examples →

Build a multi-vendor checkout.

SDK 2.7.0 adds a separate Marketplace client for vendors, invoice shares and payouts. Use a dedicated, scoped key on your backend.

Marketplace API → · Marketplace SDK guide →