Stripe Payment Gateway

Business Directory supports 5 payment gateway modules:

1. Authorize.net (included in the Core Plugin)
2. PayPal (when you buy the PayPal Premium module)
3. 2Checkout (when you get the 2Checkout Premium module)
4. Stripe (when you get the Stripe Premium module)
5. PayFast (South Africa only) (when you get the PayFast Premium module)

Google Wallet is no longer supported because Google dropped support for it officially on March 15, 2015. Others can considered for future development but they are not currently available. Less common payment gateways can be added by those who understand PHP and WordPress API programming and modeling the gateway off of the included free one in the plugin.

Installing Payment Gateways

The ZIP you download is a full WP plugin. Install it as follows:

Upload the ZIP as a plugin via the MANUAL process*. From the WordPress admin panel

• Go to Plugins->Add New,
• Click on the “Upload” link, and then click on Browse Now to locate the ZIP file you just downloaded.
• Click OK once you find it on your local computer
• Click the Install Now button to start the process.
• After the installation completes, click the “Activate Plugin” link to turn on the module

*NOTE: If you are using a Mac, the file may be automatically unzipped when you download it. You can change the default setting in Safari to only download the ZIP file and not unpack it. To do this: 1. Open Safari, 2. Click Preferences, 3. Under the General tab, uncheck the option Open “safe” files after downloading

If you have an older version installed, you will need UPGRADE it instead.  The steps are similar, but start slightly different:

• Go to Plugins->Installed Plugins
• Find the existing ‘Business Directory <gateway>’ module (where <gateway> is the name of the payment gateway, like PayPal) and click on “Deactivate”.
  
• When the operation is complete, then click on “Delete” for the same plugin.
• When that finishes, perform the steps above on installing the plugin from scratch.

Configuring Stripe Gateway

1. Install Stripe Gateway module
2. Go to Directory Admin->Manage Options->Payment
3. At the top, check “Enable Payments”.
4. Click on the Stripe sub-tab
5. Check the box to activate Stripe gateway option
6. Enter your Live API keys from the Stripe account information
7. (Optional, but recommended) Enter your Test API keys from the Stripe account information
8. (Optional, but recommended) Put the payment gateways in test mode. Uncheck this when done testing!
9. Change your currency, if applicable
10. Change currency display options, if you want
11. Turn on the abandoned cart emails, if desired
12. Save settings
13. Create one or more Fee Plans
14. Update your Stripe webhooks with the URL given under Directory Admin->Manage Options->Payment->Stripe (click the link for documentation in Stripe on how to do that)
15. You’re ready to test payments. Logout as Administrator and attempt to place a listing–verify that it goes through.
    1. Payments will not be taken if you are logged in as the administrator!

• TEST Secret Key – Required. You’ll find the value for this key in your Stripe dashboard. It is used by the module to communicate with your Stripe account. Do not share this key with anyone.
• TEST Publishable Key – Required. Same as above.
• LIVE Secret Key – Required. Same as above.
• LIVE Publishable Key – Required. Same as above.
• Use a custom form instead of a “Stripe Checkout” button? – Optional. This setting controls whether the module displays a custom form where users enter their credit card information or a standard Stripe checkout button.
  • When disabled (the default), a regular Stripe checkout button will be displayed during the checkout process. The credit card information is entered in an overlay screen that Stripe creates. This is consistent with the Stripe experience in other sites but may not actually match the look and feel of your site.  The button looks like this:                                                                                                .
  • Clicking on the button will create a popup in the browser where the credit card information is collected directly:
    
  • If you enable this option for a custom form instead, a custom form for entering the credit card details will be used. This form matches the look and feel of your site and you can add further customization with CSS overrides.  The default form looks roughly like this (although this will vary based on your theme’s CSS):
  • You can also require billing info by using the BD checkout form by enabling this Stripe Module option:

    

    The BD form includes email, first and last name, CC info and Billing address, verifying required data on submit.

• Verify billing address during checkout?  This option turns on a stronger version of Stripe’s fraud protection for you.  It will require the user to enter a billing address for their credit card, and this must match the user’s credit card details.  Use this if you’re concerned about fraudulent transactions made on your site.
• Enable Bitcoin (BTC) Support?  Stripe supports accepting payments via Bitcoin.  If you want to accept them as well, turn this option on.  Additional transaction fees in Stripe may apply.