Stripe integration
Stripe integration adds Zevio Pay as a custom payment method in Stripe Payment Element on your site. Customer selects Zevio Pay → redirect to Zevio checkout (BLIK/card) → on success the payment is reported to Stripe Payment Records API. Section Developers → Stripe (/dashboard/developers/stripe) requires a plan with Developers access and OWNER/ADMIN role. Does not work with Stripe Checkout Sessions (hosted checkout) - Payment Element only.
Integration list
Page shows created integrations with status (PENDING, ACTIVE). With no integration - Create integration button. After create see details: integration ID, API endpoint, webhook endpoint, webhook secret (copy immediately - shown once).
Create integration - form fields
Create integration modal (field order):
- Stripe Account ID (required) - format
acct_xxx. From Stripe Dashboard. - Stripe Secret Key (required) - format
sk_live_xxxorsk_test_xxx. Password field; cannot be read again from the panel after save.
After save integration status is PENDING - configure custom payment method in Stripe and Connect Payment in Zevio panel.
Stripe step: custom payment method
- Stripe Dashboard → Settings → Payments → Custom payment methods.
- Create type (e.g. name Zevio Pay) with Zevio logo.
- Copy Custom Payment Method Type ID (
cpmt_xxx).
Connect Payment - form field
For PENDING integration: Connect Payment → Custom Payment Method Type ID field (cpmt_xxx, required). On success status becomes ACTIVE - you can accept payments via Payment Element.
API endpoint and webhooks
In integration details copy API endpoint - used from your frontend when customer selects Zevio Pay (payment initiation). Webhook endpoint and Webhook secret verify events from Zevio (payment status changes). Optionally in Stripe Dashboard add a Stripe webhook to the same Zevio endpoint for payment_intent.succeeded, payment_intent.payment_failed, checkout.session.completed.
Payment methods in API request
BLIK or CARD and recurring options (frequency, blikModel A/M/O) are passed in each request body - not stored permanently on the integration. Field details: REST API docs in panel (Developers → REST API).
Delete integration
Delete integration - permanent removal; active Payment Element will stop initiating new payments through this integration.