Stripe Pro - Setup Documentation
Table of Contents
In order to use the Stripe Pro payment gateway extension, you must first have a Stripe account. It's free to create a Stripe account, and testing it is also free. Also see Stripe's business information requirements.
Upgrading from the free version of Stripe in EDD?
If you are currently using the free version of Stripe in EDD (i.e. Stripe Standard) and want to upgrade to Stripe Pro, there are no additional steps required. Once the Stripe Pro plugin is installed and activated, you will not be charged the 2% additional fee going forward. The 2% fee is added only while using the free version of Stripe in EDD.
1. Enable the Stripe Pro Payment Gateway
Once this extension is installed and activated, go to WordPress admin → Downloads → Settings → Payment Gateways, then enable Stripe.
2. Connect with Stripe
Select the Stripe sub-tab within the Payment Gateways tab, then click the Connect with Stripe button.
This will take you to the Stripe website where you can log into your existing account if you have one or create a new account if you do not.
Note regarding API Keys:
If you already have a Stripe account and have already set up Stripe by copying and pasting your API keys into the settings page, you may see the following notice asking you to connect your Stripe account. If you do, follow the instructions and make sure you log into your Stripe account when you arrive at stripe.com.
3. Webhook Configuration
The Stripe payment gateway can automatically detect refunded purchases in your Stripe account. When a refund is detected, the corresponding purchase in EDD is also marked as refunded.
EDD creates a webhook for you, and you simply need to tell Stripe where it is. If webhooks are not configured properly or are blocked by a plugin or configuration of your site, this automatic refund detection will not function.
1. To add the appropriate webhook endpoints, in your Stripe dashboard go to Developers → Webhooks (direct link). We recommend creating two webhook endpoints: one for test mode and one for live mode. If you create both, you'll need to repeat the below process after toggling modes.
2. Click + Add Endpoint
3. Add the following URL:
Note: Replace "example.com" with your actual site URL. The exact URL you need to enter can be found in your WP admin under Downloads → Settings → Payment Gateways → Stripe.
4. "Listen to events on Connected accounts" settings should be disabled (unchecked).
5. Version should be set to "Latest API version".
6. Select the following events:
Example of how the Endpoint settings should be configured:
After you add the endpoint you will see the new URL listed in the webhooks settings.
Note: Your webhooks won't work out of the box in a local development environment like Vagrant, WAMP, MAMP, Desktop Server, or Local by Flywheel. These are typically non-publicly accessible IP addresses and Stripe can't reach them.
4. Recurring Payments Integration (required to sell subscriptions)
Additional Settings / Features
There are additional settings and features detailed below.
Billing Address Display
This drop down field will allow you to select which billing details are collected. There are three options:
- Full address - This will result in a complete address form with street, city, country, state / province, and zip / postal code being displayed.
- Zip / Postal Code and Country only - This will result in a simplified address form being displayed that asks only for zip / postal code and country.
- No address fields - This will result in no address fields being displayed.
Billing address notes
- Taxes note: if you have taxes enabled, only the full address option may be used as those fields are required for accurately calculating taxation amounts.
- Fraud note: collecting a full billing address can help reduce fraudulent charges. It is recommended that minimum zip / postal code and country be collected.
A short description about the purchase will show up on the bank statement alongside the charge. See our Stripe - Statement Descriptor doc for details on how this works.
Apple Pay / Google Pay (Express Checkout)
See Stripe - Express Checkout (Apple Pay / Google Pay) for details on how to configure Express Checkout options.
Show Previously Used Cards
This saves card information so returning customers do not have to re-enter payment details. Note, card data is securely stored on Stripe's servers, not on your site.
Split Credit Card Fields
Combined field (default):
Restrict Stripe Assets
If you meet the Buy Now requirement, this will allow customers to checkout via a popup modal. For details on how this works, see our Buy Now Buttons documentation.
The official Stripe PHP library included in EDD's Stripe Pro Payment Gateway requires PHP 5.6 or higher.