Python SDK

1
from payment_kit import PaymentKit
2
3
client = PaymentKit(
4
    token="YOUR_API_TOKEN",
5
    base_url="https://app.paymentkit.com",
6
)
7
8
# Create a customer
9
customer = client.customers.create_customer(
10
    account_id="acc_prod_abc123",
11
    email="customer@example.com",
12
)
13
14
# Create a subscription
15
from datetime import datetime
16
17
subscription = client.subscriptions.create_subscription(
18
    account_id="acc_prod_abc123",
19
    customer_id=customer.id,
20
    period_start=datetime.now(),
21
    items=[{"price_id": "prc_prod_xyz789", "quantity": 1}],
22
)
23
24
# List invoices
25
invoices = client.invoices.list_invoices(
26
    account_id="acc_prod_abc123",
27
    limit=10,
28
)

1
# Production
2
client = PaymentKit(
3
    token="YOUR_API_TOKEN",
4
    base_url="https://app.paymentkit.com",
5
)
6
7
# Staging
8
client = PaymentKit(
9
    token="YOUR_API_TOKEN",
10
    base_url="https://staging.paymentkit.com",
11
)

1
import asyncio
2
from payment_kit import AsyncPaymentKit
3
4
client = AsyncPaymentKit(
5
    token="YOUR_API_TOKEN",
6
    base_url="https://app.paymentkit.com",
7
)
8
9
async def main():
10
    customer = await client.customers.create_customer(
11
        account_id="acc_prod_abc123",
12
        email="customer@example.com",
13
    )
14
    print(customer.id)
15
16
asyncio.run(main())

1
from payment_kit.core.api_error import ApiError
2
3
try:
4
    customer = client.customers.create_customer(...)
5
except ApiError as e:
6
    print(e.status_code)
7
    print(e.body)

1
# Client-level timeout
2
client = PaymentKit(
3
    token="YOUR_API_TOKEN",
4
    base_url="https://app.paymentkit.com",
5
    timeout=30.0,
6
)
7
8
# Request-level timeout
9
customer = client.customers.create_customer(
10
    ...,
11
    request_options={"timeout_in_seconds": 10}
12
)

1
# Configure max retries per request (default is 2)
2
customer = client.customers.create_customer(
3
    ...,
4
    request_options={"max_retries": 3}
5
)