YITH WooCommerce Stripe integrates credit cards and their supported circuits to pay orders placed in your shop. Please, make sure your business is located in one of the supported countries listed here.
The API keys are necessary for the plugin to process the payment requests with Stripe. You have two different pairs of Secret and Publishable keys, both for the test and live mode.
Go to the plugin settings panel and enable the option to use the plugin features.
Insert the secret key and publishable keys in the related fields for test and live mode.
If you still don’t have these keys, go to dashboard.stripe.com, register your account and click on “Developers”.
Go to the “API Keys” field to obtain the requested credentials for the plugin settings dashboard.
The administrator of the shop can decide to collect the payment right after the user’s request or postpone it to when the order will be set as Completed.
Select the capture option you want to apply by choosing from Authorize & Capture later and Authorize & Capture immediately.
By selecting Authorize & Capture later, if the order is not set as Completed within seven days, it will be automatically canceled.
YITH WooCommerce Stripe offers three different payment options:
- Standard Checkout: the credit card payment form is embedded on the checkout page of your website (SSL procedure requested).
- Stripe Checkout: this opens Stripe checkout on a separate page after clicking on the Place order button.
- Elements Checkout: shows an embedded form hosted by Stripe and certified.
A quick note about PCI Compliance.
Whatever the form selected, the transaction is always handled by Stripe and never by your own server.
Yet, some users require PCI compliance to certify that all the card sensitive data are treated safely, especially when it’s your site that receives (even if it does not store) the card details. In this case, we recommend using Elements Checkout, even if it’s always required that an official institution certifies the site’s PCI compliance.
So, what’s the real difference between Stripe Checkout and Elements Checkout?
With Stripe checkout, the form is printed out by your server (so, it gives room for collecting data and handling them), whereas with Elements checkout, the form is entirely handled and printed out by Stripe, so there’s no way for the sensitive data to even go through your server.
Please, note: in no way does the plugin stores sensitive data. Nonetheless, if you want to add this to your Terms and Conditions, it’s required that a third institution certifies it, even if you use Elements.
If you are using Standard or Stripe Elements checkout mode, you can enable the option Save Cards to let users pay with one of the cards they have used for previous orders. This will spare them the trouble of inserting their data again.
You can also choose to automatically save credit cards by selecting Register automatically in the option Card registration mode. This will allow having every card used by the customer automatically saved.
On the contrary, if you want users to choose whether to save their credit cards or not, select Let user choose.
Users can refer to the credit cards they used right inside the Payment methods section on their My Account page.
From this section, customers can also add new credit cards that will be available for future purchases as well.
To add billing and shipping fields when using the Stripe Checkout mode, you can enable the options Add billing fields for Stripe Checkout and Add shipping fields for Stripe Checkout that you can find in the plugin settings.
Here, you can also find the option Add billing fields that can be enabled in case you are using a WooCommerce extension to edit checkout fields. By enabling this option, you can require the necessary information associated to the credit card to further reduce the risk of fraudulent transactions.
Through the Customization options, you will be able to customize the texts shown to users during the checkout process.
- Title: enter the title to show to users at the checkout;
- Description: enter the description to show to users at the checkout;
- Button label: enter the label to show to users at the checkout;
To prevent payments with credit cards for those users who have a payment request previously rejected and hide the payment gateway on frontend, you can enable the option Enable Blacklist.
After enabling this option, a new tab (Blacklist) will show in the plugin panel. Here you will find the list of users automatically added after their payment request failed.
To unban users, you can do it both singularly, through the option on the right side, or massively through the bulk actions. After unbanning users, they will still show on the blacklist and their status will change into Active.
To test Stripe gateway and debug the payment system before going into production, enable the option Enable test mode.
You can also activate the log procedure so that all the actions performed by the plugin with test orders are recorded. The path of the log file shows under the Debug Log option. Administrators can consult the recorded logs even from their account, without activating this option.
By normal usage, you should never see a warning, but if you create a staging installation or clone your production site, the Test Mode will be activated and a warning will show. This will protect both you and your customer.