You are viewing beta documentation for Formie 4.x.
Payments

Stripe

Follow the below steps to connect to the Stripe API.

Step 1. Create the Integration

  1. Navigate to FormieSettingsPayments.
  2. Click the New Integration button.
  3. Select Stripe as the Integration Provider.

Step 2. Connect to the Stripe API

  1. Go to your Stripe Developers - API Keys page in your Stripe dashboard.
  2. On the top-right of your screen, ensure the Test Mode lightswitch is in the off position if you wish to use Live details, or on if you wish to use Test details.
  3. Copy the Publishable Key from Stripe and paste in the Publishable Key field in Formie.
  4. Copy the Secret Key from Stripe and paste in the Secret Key field in Formie.
  5. We strongly recommend you use .env variables to store these keys.

Step 3. Test Connection

  1. Save this integration.
  2. Click on the Refresh button in the right-hand sidebar.

Step 4. Configure Webhooks (for subscriptions)

  1. In order for subscriptions to work, you must populate some settings for webhooks.
  2. In Stripe, on the left-hand sidebar menu, click Developers.
  3. On the top sub-menu, click Webhooks.
  4. Click the Create an event destination button.
  5. Copy the Redirect URI from the Formie integration settings and paste in the Endpoint URL in Stripe.
  6. Click the Select Events button under the "Select events to listen to" heading.
  7. We recommend emitting all possible events, but the required events are:
    • customer.subscription.created
    • customer.subscription.deleted
    • customer.subscription.updated
    • invoice.created
    • invoice.payment_failed
    • invoice.payment_succeeded
    • payment_intent.succeeded
    • payment_intent.payment_failed
    • payment_intent.canceled
    • plan.deleted
    • plan.updated
  8. Once created look for the Signing secret item and click Reveal Secret.
  9. Copy the Signing secret from Stripe and paste in the Webhook Signing Secret field in Formie.

Step 5. Field Setting

  1. Go to the form you want to enable this integration on.
  2. Add a Payment field to your form.
  3. Select Stripe for the Payment Provider.

Your form must use the Ajax (Client-side) submission method when using the Stripe payment integration in your form.

The Stripe payment integration supports both once-off payments and subscription-based payments.