Marketplace · Extension
Stripe
Stripe Checkout met provider-discovered betaalmethodes, ondertekende webhooks, refunds en statusreconciliatie.
Over dit package
Wat het pakket doet
De Stripe-extension is production-ready voor de huidige Agovena-contracten. Ze gebruikt Stripe Checkout, ontdekt beschikbare Checkout-methoden, filtert methodes op billing country en verwerkt ondertekende webhooks idempotent. Agovena verzamelt geen ruwe kaartgegevens.
De extension ondersteunt test mode en live mode, volledige en gedeeltelijke refunds, status synchronization en ondersteunde off-session charges. Een return URL bevestigt nooit zelfstandig een betaling.
Instellen
Configureer secret_key en webhook_secret in Admin > Extensions > Stripe. Gebruik tijdens ontwikkeling een sk_test_...-sleutel en een bijpassende whsec_... signing secret. Gebruik voor productie een aparte sk_live_...-sleutel en live webhook secret.
Webhookroute:
POST https://shop.example.com/webhooks/payments/stripe
Voor lokale tests kun je Stripe CLI gebruiken:
npm install -g @stripe/cli
stripe login
stripe listen --forward-to http://127.0.0.1:8000/webhooks/payments/stripe
Bewaar CLI-secrets en API-keys uitsluitend in de beschermde runtimeconfiguratie. Deel ze niet en commit ze nooit.
Foutafhandeling
Stripe-signatures worden vóór parsing gevalideerd. Duplicate events worden niet opnieuw toegepast. Een onbekende of onzekere provideruitkomst blijft pending of wordt gereconcilieerd. Betaalmethodes worden opnieuw server-side gevalideerd op basis van het billing country.