integrateledger

The server-side Python SDK for Ledger's billing and usage API. Install it with python3 -m pip install integrateledger, then use from integrateledger import ledger. The capitalized Ledger class and ledger_sdk import remain available for existing source users. See the Ledger quickstart for examples.

From a repository checkout, run the SDK tests with:

python3 -m pip install ./packages/sdk-python
python3 -m unittest discover -s packages/sdk-python/tests -v

import os
from integrateledger import ledger

client = ledger(api_key=os.environ["LEDGER_API_KEY"])
client.create_feature(id="api_call", name="API call", credit_cost=1)
client.create_plan(id="starter", name="Starter", monthly_credits=100, monthly_price_cents=0)
client.create_or_get_customer(customer_id="buyer_123")
client.attach(customer_id="buyer_123", plan_id="starter")
customer = client.get_customer(customer_id="buyer_123")
print(customer["availableCredits"])
if client.check_credits(customer_id="buyer_123", feature_id="api_call")["allowed"]:
    client.track_usage(customer_id="buyer_123", feature_id="api_call", request_id="buyer_123_first_call")

Methods return response dictionaries and use Python snake_case arguments. The client maps them to Ledger's JSON contract and sends the organization key in the Authorization header. Pass base_url="http://127.0.0.1:3001" for a local API.

Use a ledger_test_ key for Sandbox or a ledger_live_ key for Live. The key chooses the environment; the client methods and API URL stay the same. Store these keys in separate server-side variables, and complete sandbox validation before enabling live payments.