Skip to main content
Official SDKs provide typed or idiomatic wrappers around the Billions public API.

TypeScript SDK

For Node.js and TypeScript applications. Published as @billions-works/sdk-ts.

Python SDK

For synchronous and asynchronous Python 3.10+ applications. Published as py-billions-sdk.

PHP SDK

For PHP 8.1 and newer. Published as billions-works/sdk-php.
All SDKs default to:
  • API host: https://api.billions.works
  • Public API version: v1
For sandbox testing, configure the SDK base URL as https://api-sandbox.billions.works.

Shared concepts

The SDKs preserve public API field names such as order_no, invoice_url, and expires_at. All support idempotent invoice creation and invoice lookup by order number. They also provide country lookup, invoice fee estimates, webhook signature verification, authenticated invoice retrieval from a webhook, and signed withdrawals and refunds. Configure secretKey (or Python secret_key) with the original API secret for signing. The older webhookSecret / webhook_secret option is still accepted; if both are set, their values must match. Choose the SDK matching your backend runtime. API keys must never be used in frontend or mobile client code.