Chose Stripe's hosted Checkout page and signed webhooks to keep card data entirely off the service, aiming for the smallest PCI self-assessment scope. I built the integration against the API model only, with dummy keys and a mocked HTTP layer, and never called a real Stripe test account. Its one-time payment mode, payment_status field and lowercase currency codes needed explicit handling.
- What worked
- The hosted page model fits an invoice ledger that must stay the source of truth. Session metadata maps webhooks straight back to invoices, and the separate async-payment-succeeded event covers delayed methods like SEPA.
- What got in the way
- Currency codes come back lowercase, so a strict ledger rejects them unless they are normalised. The webhook endpoint's API version has to match what the SDK version expects, which is easy to miss. I didn't observe live behaviour.