Stripe Integration

Stripe is available on every Flex Forms plan. There is no separate “Enterprise-only Stripe” tier — you need a Stripe account and a published form with a Payment block.

​

Architecture

A form may contain at most one Stripe Payment block.

---

​

Connect Stripe (global)

---

​

Payment block settings (Studio)

After Stripe is Ready, insert Stripe Payment from Payments (see also the block page). Configure on the block (not in Form Integrations):

• Required — when off, respondents may submit without paying (optional payment / donation-style forms)
• Payment type
  • Fixed amount — one charge amount
  • Product options (choice cards) — labeled options with prices (Studio canvas: Add option → name + price). On fill, respondents pick a radio card.
  • Customer enters amount — free amount field; optional minimum / maximum toggles with amounts below each toggle
  • From a form field — pick a Number, Number stepper, or Currency field from a dropdown (Amount field)
• Also allow custom amount — when using Product options, let respondents type their own amount instead
• Currency — one currency for the whole Payment block
• Charge description
• Capture — Automatic or Manual authorize
• Payment methods
  • Automatic (Dynamic payment methods) — Stripe shows relevant methods for the currency and your Dashboard (cards, BLIK, Przelewy24, Klarna, Apple Pay / Google Pay when eligible)
  • Cards only — card Payment Element only
• Stripe receipt email — Stripe’s API supports PaymentIntent.receipt_email and emails a receipt on successful capture. Flex Forms options:
  • Do not send
  • Primary email on the form
  • Specific email field
  • Email collected in Stripe Payment Element — uses the billing email typed in the payment UI (ConfirmationToken → patch PI → confirm)
• Collect billing name, email, phone, address — Stripe’s Payment Element collects these when the selected payment method needs them
• Collect shipping address — when on, Stripe can collect a shipping address in the payment form
• Show amount summary
• Save payment method (setup_future_usage)
• Statement descriptor suffix

Successful charges write payment method type (card / BLIK / P24 / …) plus card brand + last 4 into the Transactions ledger (never the full card number).

---

​

Poland / wallets checklist (Dynamic payment methods)

Use Payment methods → Automatic and complete these in Stripe (not inside Flex Forms):

1. Payment methods — enable BLIK, Przelewy24, Klarna, cards, wallets as needed
2. Charge currency on the block (e.g. PLN for BLIK)
3. Public fill URL over HTTPS (required for wallets)
4. Register your domain for Apple Pay in the Stripe Dashboard
5. Test with Stripe test cards / test BLIK codes before switching to Live

Flex Forms does not hard-code a method list — Stripe’s Payment Element decides relevance from Dashboard + currency + respondent context.

---

​

Fill runtime

1. Stripe.js loads only on fill/embed when the form includes the Payment block.
2. Respondents see fixed amount, product choice cards, and/or a custom amount field — depending on Payment type.
3. Payment Element mounts in accordion layout (radios always visible) with your publishable key.
4. On submit (when Required is on), Stripe confirms the PaymentIntent.
5. When Required is off, submit can succeed without a payment.
6. Flex Forms verifies amount, currency, form metadata, and mode — then saves the submission and writes the Transactions ledger.
7. The submit button stays disabled with a sending label until the AJAX request finishes (no full page reload).

Card numbers never touch Flex Forms storage.

​

Preview vs published

---

​

Transactions hub

Open Transactions in the Flex Forms left rail (next to Contacts). You’ll see cursor-paginated payments with provider, status, amount, payer, and form. From the hub you can:

• Export CSV (respects filters)
• Refund (full remaining balance) or Partial… refund for Stripe payments that are succeeded or partially refunded

Hub refunds call Stripe immediately and update the ledger; webhooks may also sync charge.refunded events (including refunds started in the Stripe Dashboard). Permissions (optional Spatie): viewTransactions, exportTransactions, refundTransactions — see Studio permissions.

---

​

Troubleshooting

---

​

Credit card block vs Stripe Payment

The Credit card input block is not a gateway. For live charges use Integrations → Stripe + the Stripe Payment block.