Flaxon Stripe

flaxon-stripe exposes a configured Stripe SDK client at app.state.stripe. It also provides a safe webhook signature-verification helper. It does not create payment routes automatically: applications should define their own authorization and business rules.

Install

pip install flaxon-stripe

Use

import os

from flaxon import Flaxon
from flaxon_stripe import StripePlugin

app = Flaxon("billing")
await app.plugins.load_plugin(
    StripePlugin(
        api_key=os.environ["STRIPE_SECRET_KEY"],
        webhook_secret=os.environ["STRIPE_WEBHOOK_SECRET"],
    )
)


@app.post("/stripe/webhook")
async def stripe_webhook(request):
    event = app.state.stripe.verify_webhook(
        await request.body(),
        request.headers["stripe-signature"],
    )
    return {"received": event["id"]}

Use Stripe's official API version configuration, keep both secrets out of source control, and make webhook processing idempotent. A successful HTTP response must only be sent after the event has been durably recorded or safely queued.