# mod\_payment\_stripe

Source: https://zotonic.com/docs/3161/mod_payment_stripe

URI: https://zotonic.com/id/3161

Language: en



Provide Stripe Checkout payments through `mod_payment`.

Enable this module together with `mod_payment`. Configure `secret_key` and `webhook_secret` under **System → Payment configuration**, requiring `use.mod_admin_config`. Use credentials and a signing secret for the intended Stripe environment. Set `#payment_request{preferred_psp_module = mod_payment_stripe}` to select Stripe. This adapter creates payment-mode Checkout Sessions and does not create recurring subscriptions.

Configure Stripe to deliver Checkout Session events to `/stripe/webhook`. Incoming requests are verified with `webhook_secret` before their session data is passed to the shared payment receive logic. The browser returns through `/stripe/ready/:payment_nr`; status is synchronized with the Stripe API.

When `mod_payment.accept_unknown_payments` is enabled, verified webhooks may import unknown payments. Four-hour discovery additionally requires that `mod_payment.disable_unknown_payment_polling` is false. Discovery covers payment-mode Checkout Sessions within the shared retention window; direct Charges, PaymentIntents and subscriptions are not discovered.

License: 

Attribution: 

Related resources: https://zotonic.com/api/agent/related/3161?language=en


## API access

- [API help](<https://zotonic.com/api-help>)
- [OpenAPI specification](<https://zotonic.com/openapi.json>)
- [This resource as JSON](<https://zotonic.com/api/agent/resource/3161?language=en>)