Setting Up the Stripe Add-On (version 2.7 and earlier)



The Stripe settings layout was modified in Stripe Add-On version 2.8. For current versions, refer to our updated article.
This article is for users of version 2.7 or earlier.

Pre-Requisites

Stripe Settings

The Stripe Settings will allow you to connect and authenticate with your Stripe account and make some choices about how you collect payment information. Additionally, it will allow you to setup webhooks which are used to communicate events from Stripe back to your Gravity Forms environment.

Navigate to your Stripe Add-On Settings page:

  1. Log into your WordPress admin dashboard.
  2. On the left side navigation menu, hover over Forms and click on Settings.
  3. Click the Stripe tab.

Stripe 2.7 and below Settings

Stripe API

Allows you to specify the environment you want to send your form submission to. Choosing Live will initiate real transactions, while Test will run the form entry into your Stripe test environment, which should not generate any real transactions.

Stripe 2.7 API Settings

  1. Select the API to use for Stripe integration: Live or Test. Live is for real transactions, and Test is for testing the integration and submitting test forms.
  2. Enter the Live Publishable Key and Live Secret Key for your Stripe account if using Live mode. Or enter the Test Publishable Key and Test Secret Key for your Stripe account if using Test mode. For details on how to get your API information, refer to Obtaining Your Stripe API Keys.
  3. Click Update Settings.

If you’ve entered your API information correctly, you will be notified by green check marks beside each box. If you do not see green check marks, please double check this information and try again.

Stripe API Settings

Payment Collection (available in Stripe v2.6 and later)



This option was introduced in Stripe version 6. It is not on the Settings page for earlier versions.

Stripe Payment Collection

  1. Scroll to the Payment Collection section.
  2. Select the Payment Collection Method to determine how payment information will be obtained on your form. Refer to this article for more information on the payment collection methods offered.

Stripe Webhooks

Stripe 2.7 Webhooks Settings

  1. Log in here to access your Stripe Webhooks management page.
  2. In Stripe, click the Add endpoint button at the top right above the list of webhooks.
    Note: There is a maximum limit of 16 webhook endpoints per Stripe account.
  3. In the Endpoint URL field, paste the URL found under “View Instructions” on the Gravity Forms Stripe Settings page (see screenshot below).
  4. Under Version, select the Latest API Version if available (see screenshot below).
  5. Under Events to send, click receive all events from within the box (see screenshot below).
  6. Click the Add endpoint button to save the webhook (see screenshot below).
  7. Under Signing secret, click the “Click to reveal” button.
  8. Copy the signing secret and note the Mode at the top of the screen.
  9. Enter the Signing Secret from the Stripe Webhooks page into the Stripe settings. Use the Test Signing secret or Live Signing secret field as applicable.
  10. Check the I have enabled the Gravity Forms webhook URL in my Stripe account. box.
  11. Click Update Settings.

Stripe add a webhook endpoint annotated2

Screenshot: Adding a Webhooks endpoint in Stripe

Once you have entered your Stripe settings, you’re ready to begin Setting Up a Stripe Compatible Form.