hatchup-payment-service-integration 1.1.5

Python SDK for integrating with the Hatchup Payment Service.

Hatchup Payment Service Integration

Python SDK for integrating with the Hatchup Payment Service — an internal Stripe Connect gateway.

Status: 0.4.0 — sync + async client, webhooks, Django integration, and contract tripwire shipped. Stabilizing toward 1.0.

What this is

A framework-agnostic Python client for any Hatchup product that needs to take payments. The SDK proxies every Hatchup Payment Service feature behind typed resource classes, parses inbound webhooks, and ships an optional Django integration. Direct Stripe SDK access is intentionally out of scope — see docs/STRIPE_PASSTHROUGH.md.

Install

pip install hatchup-payment-service-integration
# with Django helpers
pip install "hatchup-payment-service-integration[django]"

Requires Python 3.12+.

30-second example

from pydantic import SecretStr
from hatchup_psip import PaymentServiceClient, PSIPConfig

with PaymentServiceClient(PSIPConfig(api_key=SecretStr("hp_..."))) as client:
    response = client.payments.create(
        price="9.99",
        order_id="ord_2026_05_001",
        success_webhook="https://app.example/psip/webhook/",
        failure_webhook="https://app.example/psip/webhook/",
    )
    print(response.payment_url)   # → redirect the buyer here

Documentation

• docs/quickstart.md — install, construct a client, call every resource, error hierarchy.
• docs/webhooks.md — read before deploying. Webhooks are not signed today; the SDK's verify-by-default dispatcher is the only forgery defence.
• docs/django.md — PSIPWebhookView, settings.PSIP, three wiring patterns.
• docs/STRIPE_PASSTHROUGH.md — why the SDK does not wrap the Stripe SDK directly.
• CHANGELOG.md — release notes.

Roadmap

• M0 — toolchain bootstrap (0.1.0, shipped)
• M1 — sync client + webhooks (0.2.0, shipped)
• M2 — Django integration (0.3.0, shipped)
• M3 — async client (0.4.0, shipped): AsyncPaymentServiceClient, paired async resources, AsyncWebhookDispatcher.
• 1.0.0 (planned): stabilization after launchpad-backend's first integration cycle.

Development

# install dev deps
uv sync

# format + lint + types
just all

# run tests (skips `live` integration tests by default)
just test

# coverage report
just cov

# build wheel + sdist
just build

License

MIT — see LICENSE.