Connecting to Stripe in Live or Test Mode

Introduction

The process to connect to either is similar, but we have noticed some differences when connecting a test account and using the Skip This Form option. This document explains how to connect to either Mode.

You have two Mode options when connecting Gravity Forms to your Stripe account: Test and Live.

Pre-Requisites

See this guide for all the pre-requisites.

Connect to a Live Account

If connected to the live Stripe environment, any transactions passed will attempt to generate real charges.

  1. Ensure that two-factor authentication (2FA) is enabled in your Stripe account Settings. For assistance, see this Stripe guide.
  2. Navigate to Forms → Settings → Stripe Settings, and look for the Stripe Account section.
  3. Set the Mode to Live.
  4. Click the “Connect with Stripe” button.
Image showing Live mode selected
  1. You will be presented with the Stripe sign-in page. Complete the sign-in process.
  2. You should now see a Stripe account selection page (these accounts are created from within your Stripe service dashboard; see this guide). The email address of your Stripe account will be displayed at the top of the page.
Image showing account selection for Stripe Live mode.
  1. Select the account you wish to use to collect live payments and click the “Connect” button. 
  2. You may be presented with various Stripe forms requesting additional business information if your account is not fully setup for live payment. Complete any information Stripe requires, and then authorize the account to confirm connection to your Gravity Forms.
  3. You will be returned to the Stripe Settings page. You should see “Connected to Stripe as” with your account name as well as a “Disconnect” button.
Image showing Stripe Add-On connected to Live mode.

Connect to a Test Account

Connecting to a Test account allows you to have a sandbox for testing the passing and behavior of submissions between your form and Stripe, but will not generate real transactions.

Unlike when connecting to a live account, this time you will not “Connect”, but will instead “Skip This Form”. This avoids all the Stripe account and connected bank verification steps that would otherwise be requested, and are not necessary when doing test submissions. To skip this step, you must have two-factor authentication enabled in your Stripe account

  1. Ensure that you have two factor authentication (2FA) enabled in your Stripe account Settings. See this Stripe guide for assistance.
  2. Login to your Stripe account and navigate to your Profile screen (click the icon in the top right corner).
  3. Go back to your WordPress dashboard, and navigate to your Forms → Settings → Stripe Settings, and look for the Stripe Account section.
  4. Set the Mode to Test.
  5. Click the “Connect with Stripe” button. You will get a “redirecting you to Stripe” screen.
Image showing Test mode selected
  1. If you logged into Stripe at Step 1, you should now see a Stripe account selection page (these accounts are created from within your Stripe service dashboard, see this guide). If not, you will bet presented with the Stripe login dialog first.
Image showing account selection for Stripe Test mode.
  1. Once logged in, this screen shows the email address of your Stripe account, and the words Test Mode, will be displayed at the top of the page. From the list of Stripe accounts provided, choose the account you wish to connect to for testing.
  2. Click “Skip this Form” at the top of page (next to where it states “You’re currently in test mode”).
Image showing Skip This Form link.
  1. You should now be redirected back to your Gravity Forms settings page, and see the the Stripe Account panel now says “Connected to Stripe Account…” and the name of the account you chose in step 7 should be displayed.
Image showing Stripe Add-On connected to Test mode.

Note: If your Settings screen shows “Unnamed account“, this most likely means you did not have 2FA properly set. This is a newly created anonymous account, but as it is not connected to your account, you cannot see any of the test transactions you run. Disconnect this newly created account and follow the instructions above.

Test Cards

Stripe provides a set of test cards that you can use to test different scenarios. Please check Stripe’s official Testing documentation for more details.

Notes

  • Once you have connected your Stripe Add-On to your Stripe account in Test mode, please review the Stripe instructions for testing your integration → Testing.
  • You can find credit card numbers for testing Stripe here.