Billing & Payments

Stripe Monetization

Bidirectional webhook sync with client-side tokenization.

HOW IT WORKS

Integration Architecture

ARCHITECTURE

Webhook events drive invoice state transitions asynchronously. Idempotency table prevents double-processing on at-least-once delivery.

DATA BOUNDARY

Every data point Aforo captures and every action it executes on Stripe.

Ingestion (What We Receive)

01payment_intent.succeeded

02checkout.session.completed

03setup_intent.succeeded

Mutation (What We Execute)

01POST /v1/customers — Create customer record

02POST /v1/payment_intents — Off-session dunning

CONFIGURATION

Drop this configuration into your Stripe setup. Aforo handles batching, retries, and cost attribution.

application.ymlyaml

aforo:
  stripe:
    enabled: true
    secret-key: ${STRIPE_SECRET_KEY}
    webhook-secret: ${STRIPE_WEBHOOK_SECRET}
    idempotency: true

First integration takes under 5 minutes. No credit card required.