Thank you for purchasing our extension. If you have any questions that are beyond the scope of this document, do not hesitate to leave us an email via our email address below.

Created: 08/11/2016 | By: Magenest | Support Portal: http://servicedesk.izysync.com/servicedesk/customer/portal/22

Introduction

Stripe Payment Gateway And Subscription extension by Magenest is the ultimate tool that provides seamless payment experience between your Magento 2 store and the Stripe Payment Gateway.

Extension's page: Stripe Payment Gateway And Subscription.

Features For Admins

• A lot of features is included in the extension that you can tweak to make it best suit your business, including:

• Choose between Authorize Only or Authorize and Capture.

• IFrame Checkout Form
• Alipay, Giropay, Apple Pay, Google Pay
• 3D Secure

• Various credit card types

• Enable CVC/AVS Verification

• Access to more than 25 countries

• Restrict unwanted countries from payment

• Support Save Card function

• Easily partial capture invoice.

• Conveniently partial or total refund.

• Support 135 currencies
• Support MOTO (Making payment from backend)

• Support Giropay, Alipay, SOFORT, Bancontact, EPS, etc.

Features For Customers

• The primary aim of the extension is to deliver the most fluent and effortless payment experience to the customers:

• • • Easily checkout using credit card.
    • Manage subscriptions
    • Sign up for an account to save credit card information for future purchase
    • Flexible payment choices

System Requirements

 Your store should be running on Magento 2 version 2.0.x; 2.1.x, and 2.2.x

Configuration

Set Up Stripe Online Account 

Merchant needs to have a Stripe account to use our extension. If you have not any Stripe accounts, you need to create a new account by clicking on the following link: https://dashboard.stripe.com/register.

Then, choose Create your Stripe account to set up a new account:

Once you have the Stripe account, sign into your account.

After that, click on API at the left corner > API Keys to take API Keys.

Set Up The Integration On Magento 2 

At back end, you need to configure some fields to connect between your Magento site and the stripe account. 

First, click on Stripe Payments > Settings > Stripe Payment Gateway

Requirement Settings

• Sandbox Mode Enabled: Turn this on (Yes) for test mode, remember to use test key and test cards for testing. Other please turn this off (No) when you go Live.
• Test/Live Publishable Key: 

 If you use the Test Key:

• You should fill in Stripe API Test Keys in Test Publishable Key, Test Secret Key to connect Magento and Stripe Payment Gateway.
• Turn on the Sandbox Mode Enabled by choosing Yes.

 If you use the Live Key:

• Fill in your Stripe API Keys in Live Publishable Key, Live Secret Key to connect Magento with Stripe Payment Gateway.
• Turn off the Sandbox Mode Enabled by choosing No.

Title: the title of the payment method displayed on the Checkout Page.

 You can set the Payment Action to be Authorize and Capture or Authorize Only

• Authorize Only (Authorization): will check the card for validity but not charge the account yet until the order is approved and invoiced.
• Authorize and Capture(Sale):  will charge the debit/credit card at the time of the order submission.

 Select Stripe API Integration: There are 3 Stripe API to choose

1. Stripe.js v3 & Elements. Pre-filled SAQ A
2. Stripe.js v2. SAQ A-EP
3. Directly to the API. SAQ D

It is highly recommended to use Stripe.js v3 & Elements for advanced security features.

Note: In order to enable 3D secure, you must use Stripe.js v3 & Elements or Stripe.js v2.

 3D Secure: Choose Yes to enable 3D secure for Stripe payments

The behavior and application of 3D secure varies across card types and networks. Some card issuers does not support this verification method, in order to deal with that, you can choose 1 of 2 options for 3D secure application:

• 3D secure is recommended: The process is not required, but you can be covered by liability shift.

• 3D secure is optional: The process isn’t required but can be performed to help reduce the likelihood of fraud.

 Note that 3D Secure cannot be used for Subscription Products.

 You can set the New Order Status: Processing, Suspected Fraud

• Processing: The payment is made successfully and an order invoice is issued.
• Suspected Fraud: No invoice is issued. 

 Allowed Credit Card Types: You can choose which credit card types are accepted on your site by choosing one or more items.

 Payment from Applicable Countries: 

• All allowed countries:  Enable all allowed countries to make payment.
• Specific Countries: Restrict some countries by unselecting them from the Payment from Specific Countries.
  

 In addition, you can add/edit the Instructions to instruct customers how to do payment.

 Sort Order: The order of the payment method that will be displayed on the checkout page.

Subscription Configuration

 Subscription Billing: You can choose to Send Invoice to customers or Charge for the subscription automatically.

 Apply tax for each subscription item

 Cancel at period end

 Note that subscription product cannot be in the same cart with one-time purchase product

 Subscription products in the same cart have to be in the same billing cycle

Stripe IFrame Checkout Form

 Enabled: Choose Yes to enable the IFrame checkout form method

 Title: Edit the title for the payment method. Here we recommend you to set it as "Stripe Checkout IFrame"

 You can set the Payment Action to be Authorize and Capture or Authorize Only

• Authorize Only (Authorization): will check the card for validity but not charge the account yet until the order is approved and invoiced.
• Authorize and Capture(Sale):  will charge the debit/credit card at the time of the order submission.

 You can set the New Order Status: Processing, Suspected Fraud

• Processing: The payment is made successfully and an order invoice is issued.
• Suspected Fraud: No invoice is issued. 

 3D secure: The 3D secure settings for this method will follow the 3D secure settings in Stripe Payment Settings. Note that you don't have to enable Stripe Payment Settings to make it work, just change the 3D secure settings then Save Config. 

 Name of website displayed on Checkout: Your store name.

 Panel Label: The label of the payment button in the Checkout form

 You can turn on Allow Stripe Checkout to collect customer's billing address, shipping address and zip code

 Remember Me: If you set this option to Yes, Stripe will save the customer's information for later purchase in every website that use Stripe Payment Gateway.

 Logo image: The logo image that will be displayed on the Iframe form.

 Sort Order: The order of the payment method that will be displayed on the checkout page.

 Payment from Applicable Countries: 

Apple Pay, Google Pay, Microsoft Pay

 Enable this method: Choose Yes to enable Apple Pay, Google Pay, Microsoft Pay

 Title: Fill in the title for the payment method

 You can set the Payment Action to be Authorize and Capture or Authorize Only

• Authorize Only (Authorization): will check the card for validity but not charge the account yet until the order is approved and invoiced.
• Authorize and Capture(Sale):  will charge the debit/credit card at the time of the order submission.

  You can set the New Order Status: Processing, Suspected Fraud

• Processing: The payment is made successfully and an order invoice is issued.
• Suspected Fraud: No invoice is issued. 

 Replace default Place order button: Enable to replace the default Place Order button with Apple Pay, Google Pay or Microsoft Pay Place Order button. Note that this option can cause conflict with One step Checkout extension, so if currently you are using One Step Checkout, turn this option off.

 To use Google Pay (for PC), customers have to add their credit card to the browser.

Alipay Payments

You can enable Alipay Payment easily just by choosing Yes in Enabled then Save Config.

Note that the currency of the payment must be the default currency of your country. It could be AUD, CAD, EUR, HKD, NZD, SGD, or USD.

In Denmark, Norway, Sweden, and Switzerland, the currency for the payment will be exchanged to EUR.

Giropay Payments

The Giropay currency is EUR.

You can enable the payment method by choosing Yes in Enabled then Save Config.

SOFORT Payments

The SOFORT currency is EUR.

You can enable the payment method by choosing Yes in Enabled.

 Title: Fill in the title for the payment method

 Allow select bank country: Enable customers to choose their country to make payments.

 Default Bank Country: Set the default bank country to be displayed on checkout: Austria, Belgium, Germany, Italy, Netherlands, Spain

 Allow select language: Enable customers to choose the preferred language 

 Default language: Set the default language for the payment method: English, German, Spanish, Italian, French, Dutch, Polish.

iDEAL Payments

The iDEAL currency is EUR.

You can enable the payment method by choosing Yes in Enabled.

 Title: Fill in the title for the payment method

 Use iDEAL Bank Element Interface: If you choose Yes, the payment method will be displayed with iDEAL interface.

If you don't use the iDEAL interface, you can choose No and change the settings as follows:

 Allow select bank country: Enable customers to choose their country to make payments.

 Default Bank: If you don't want to allow customers to choose their bank. You can set a default bank.

Bancontact Payments

The Bancontact currency is EUR.

You can enable the payment method by choosing Yes in Enabled.

 Title: Fill in the title for the payment method

 Allow select language: Enable customers to choose the preferred language 

 Default language: Set the default language for the payment method: English, German, French, Dutch.

P24 Payments/ EPS Payments/ Multibanco Payments

Following other payment method, in order to enable P24 Payments, EPS Payments, or Multibanco Payments, you have to choose Yes in Enabled.

When done, please press Save Configuration then go to Cache Management to flush cache.

Click on the Subscription ID Number in the first column to see the details of a subscription order.

• • Easily Checkout Using Credit Card 

  At front end, customer can add the items into shopping cart by clicking the Add to Cart button. 

  

  Then, go to the checkout page. Customer fills in his/her shipping address and selects the payment method.

   Checkout with Apple Pay/Google Pay

   To use Google Pay (for PC), customers have to add their credit card to the browser.

   In case your browser can't pay button to transfer, follow this guide to display Stripe Payment request button.

  Mark the checkbox "My billing and shipping addresses are the same" if the shipping address and the billing address are not different.

  If they are different, fill in the billing address then click "Update".

  After filling in all the neccessary information, click Pay now to place the order.

  

  Stripe Apple Pay Checkout

  

  After successful payment, at Payments tab of Stripe, the order will be updated corresponding with Magento.

   

  

   

   Checkout with Stripe Giro Pay

  • Mark the checkbox "My billing and shipping addresses are the same" if the shipping address and the billing address are not different.
  • If they are different, fill in the billing address then click "Update".

  
  

  
  

  After filling in all the neccessary information, click Continue to place the order.

  Then, it redirects to Stripe Giro Pay Payment Page and buyer can finalize his payment there.

   

   Checkout with Stripe Alipay

  • Mark the checkbox "My billing and shipping addresses are the same" if the shipping address and the billing address are not different.
  • If they are different, fill in the billing address then click "Update".

  
  

  After filling in all the neccessary information, click Place Order

  Then, it redirects to Stripe Alipay Payment Page and buyer can finalize his payment there.

   

   Checkout with Stripe Checkout (Direct Checkout)

  • Mark the checkbox "My billing and shipping addresses are the same" if the shipping address and the billing address are not different.
  • If they are different, fill in the billing address then click "Update".
  • Fill in the credit card information
    

  If the customer sign in with an account, he/she can use the save card function by ticking in the Save your credit card box. 

  After filling in all the neccessary information, click Place Order to finalize the payment.

  
  

   Checkout with Stripe IFrame Checkout (Redirect Checkout)

  Another payment method is Stripe Checkout Iframe. It supports wonderful functions with Credit Card, Alipay, and Bitcoin.

  

  When customer Place order, an Iframe form will be displayed as below with 3 choices for payment methods.

  

  Credit card Iframe checkout form

  
  

  
  

  Alipay Iframe checkout form

  
  
  

  Bitcoin Iframe checkout form

  
  

  If customer enters his mobile phone number, Stripe will send a 6-number-verification code to confirm his payment info.

   

   Support 3D secure:

   When customers use type of card provided with 3D secure function. Stripe will turn on automatic mode to check. The operation will redirect to processing page:

  

  Press Success button. The inform result will sent to customer.

   

   Check out with other payments

  A part from Stripe checkout, Stripe Pay also supports multiple payment methods for customer convenience.

   

  

   

  

   Making payment from backend (MOTO)

  Customers do not always purchase online, sometimes they can order via telephone calls or emails. In these cases, it is essential that you - admin can make payments from backend on behalf of customers.

  Using PCS DSS and Stripe v3.2 security standards, you can use customers's saved cards to make payment from backend for them. In this way, customer's credit card info will be secured, rather than admin types credit card info.
  

   View Order:

   When the transaction is completed, customers can review their orders by clicking Sales > Orders > View.

   

  

   

  

   

   Capture Invoice:

  While invoice is not created meanings customers select Payment Action in Authorize Only status. Customers can capture invoice in their request. However, quantity of products in new invoice

  must be smaller or equal with pre-order and invoice only is submitted once. 

  

    View Invoice: 

   By clicking invoice and pressing View, customer can see the content of invoice that you want:

   

  

  And choose Credit Memo tab and clicking Refund in need

   

   Partial or total refund:

  Moreover, Stripe is a great tool. Customer can refund partially or totally by clicking Credit Memo-> Refund.

  About partial refund, it applies for many frequencies and up to out of products.

  

Update

• When a new update is available, we will provide you with a new package containing our updated extension.
• You will have to delete the module directory and repeat the installing steps above.
• Flush the config cache. Your store and newly installed module should be working as expected.

Support

• We will reply to support requests within 2 business days.
• We will offer lifetime free update and 6 months free support for all of our paid products. Support includes answering questions related to our products, bug/error fixing to make sure our products fit well in your site exactly like our demo.
• Support DOES NOT include other series such as customizing our products, installation and uninstallation service.

Once again, thank you for purchasing our extension. If you have any questions relating to this extension, please do not hesitate to contact us for support.

Magenest