The documentation below outlines how to connect your membership account to your Stripe account.

Gateway Setup | Webhook Setup | Apple Pay & Google Pay Setup | Live or Test Mode Settings

Connect Your Site to Stripe

Configuring Stripe for your membership site is done with the click of a single button that connects your Stripe gateway account.

  1. Navigate to Memberships > Settings > Payment Gateway & SSL in the WordPress admin.
  2. Click the “Connect with Stripe” button.

    Screenshot of the Payment Settings page before using Stripe Connect
  3. The next screen will redirect you to Stripe and, optionally, prompt you to log in to your Stripe account.
    • If you already have a Stripe account:
      1. Enter your existing Stripe account email address.
      2. Enter your existing Stripe account password.
    • If you do not already have a Stripe account:
      1. Create a new Stripe account through these steps.
  4. Once you are logged in, select your Stripe Account and click “Connect “.

    Log in to your existing Stripe account and select the account to connect at Stripe
  5. Once redirected back to your WordPress admin, confirm that the Stripe gateway account is connected.

    Screenshot of the Payment Settings page using Stripe Connect
  6. Save settings.

The Stripe integration for Paid Memberships Pro allows you to operate in two modes: “Live/Production” or “Sandbox/Testing”. You can connect to Stripe in either of these modes, using the same gateway account for both modes or a different Stripe account for each mode.

Click here for more information on using Stripe in Testing mode »

Screenshot of the Payment Settings page using Stripe Connect
Screenshot of a connected site in live mode.
Screenshot of the Payment Settings page using Stripe Connect in Test Mode
Screenshot of a connected site in test mode.
If your site is using the Legacy API Key method for Stripe, follow these steps to switch to Stripe Connect. The legacy method will be deprecated in future versions of Paid Memberships Pro.

Setting Your Webhook URL

To fully integrate with Stripe, you must configure a Webhook URL in your Stripe account. This will ensure that your membership site can stay in communication with the gateway for recurring payment notifications, payment failures, and subscription cancellations.

  1. Navigate to Memberships > Settings > Payment Gateway & SSL in the WordPress admin.
  2. Locate the “Webhook” settings field.
  3. Copy the Webhook URL from this field. The webhook URL will be in the sample format below:
    • http://www.YOURDOMAIN.com/wp-admin/admin-ajax.php?action=stripe_webhook
  4. In your Stripe account, click “Developers” in the upper right.
  5. Then, click “Webhooks” in the left column menu to navigate to the Webhooks settings page.
  6. Click “+ Add endpoint”.
  7. Enter the webhook URL that you copied in step 3 into the “Endpoint URL” field.
  8. From the “Events to send” dropdown, select the following events:
    • charge.failed
    • charge.refunded
    • checkout.session.async_payment_failed
    • checkout.session.async_payment_succeeded
    • checkout.session.completed
    • customer.subscription.deleted
    • invoice.payment_action_required
    • invoice.payment_succeeded
  9. Click “Add endpoint” to save this webhook to your Stripe account.

Enable the Payment Request Button

The Stripe gateway settings include an option to “Enable Payment Request Button”. This will allow members to pay using Apple Pay, Google Pay, or Microsoft Pay as an alternative to manually entering their credit card information. Read more about these browser payment options in our companion article here.

Using Stripe in Live or Test Mode

Testing a Stripe checkout requires you to change some settings in your membership site’s WordPress admin and to use specific testing card numbers provided by Stripe.

  1. Navigate to Memberships > Settings > Payment Gateway & SSL in the WordPress admin.
  2. Set your “Payment Gateway” to “Stripe” and set the “Gateway Environment” to “Sandbox/Testing”.
  3. Then, follow the steps in the “Connect Your Site to Stripe” section above to complete the setup. You can use the same Stripe Account for both modes, or connect a different Stripe Account for Sandbox/Testing mode. There are no gateway or platform fees charged when using your site in Sandbox/Test mode.
  4. Save settings.

To test a membership checkout, log out or visit your membership levels page in incognito mode. Stripe’s testing documentation page has test card numbers you can use for checkout. Use any valid future expiration date, any 3 digit CVV (or 4 digits for Amex) and the test card number below:

NumberCard type
Visa4242424242424242
MasterCard5555555555554444
American Express378282246310005
Discover6011111111111117