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_xxx or sk_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 PaymentCustom 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.

Stripe integration | Zevio