Skip to main content

Stripe

Overview​

Stripe is a US payment gateway that allows e-commerce sites to receive payments on their sales website. Stripe has no setup fees, no monthly fees and no hidden costs. Mageplaza Stripe extension will help you integrate this payment gateway with your store. Your customers can use all debit cards, credit cards, or local payment methods like Alipay, Giropay, Bancontact, Przelewy24, etc. This extension also includes authorize, capture and 3D secure. These settings can be easily done by admin at the backend.

Mageplaza Stripe extension is fully compatible with Mageplaza One Step Checkout

How to download and install​

How to use​

For Customer​

  • Pay by Card
  • Pay by Alipay
  • Pay with Giropay
  • Pay with Bancontact
  • Pay with Przelewy24
  • Payment by SOFORT**
  • Pay with EPS
  • Pay with iDEAL Bank
  • Pay with Google Pay
  • Pay with Apple Pay
  • Pay with Microsoft Pay

  • Verify by 3D Secure when paying by Card
  • Allow customers to save card information at their first payment to use for next payments.
  • You can check the payment by using following test card information:

Test card numbers​

Use any of the following test card numbers, a valid expiration date in the future, and any random CVC number, to create a successful payment. Each test card's billing country is set to U.S

 

NUMBER

BRAND

4242424242424242

Visa

4000056655665556

Visa (debit)

5555555555554444

Mastercard

2223003122003222

Mastercard (2-series)

5200828282828210

Mastercard (debit)

5105105105105100

Mastercard (prepaid)

378282246310005

American Express

371449635398431

American Express

6011111111111117

Discover

6011000990139424

Discover

30569309025904

Diners Club

38520000023237

Diners Club

3566002020360505

JCB

6200000000000005

UnionPay

#### 3D Secure test card numbers Not all cards [support 3D Secure](https://stripe.com/docs/payments/3d-secure) or require the customer to be redirected to their card issuer's authentication page. Use the following card information to test 3D Secure payments.

 

NUMBER

3D SECURE USAGE

DESCRIPTION

4000000000003220

Required

3D Secure 2 authentication must be completed for the payment to be successful. By default, your Radar rules will request 3D Secure authentication for this card.

4000000000003063

Required

3D Secure authentication must be completed for the payment to be successful. By default, your Radar rules will request 3D Secure authentication for this card.

4000008400001629

Required

3D Secure authentication is required, but payments will be declined with a card_declined failure code after authentication. By default, your Radar rules will request 3D Secure authentication for this card.

4000000000003055

Supported

3D Secure authentication may still be performed, but is not required. By default, your Radar rules will not request 3D Secure authentication for this card.

4242424242424242

Supported

3D Secure is supported for this card, but this card is not enrolled in 3D Secure. This means that if 3D Secure is requested by your Radar rules, the customer will not go through additional authentication. By default, your Radar rules will not request 3D Secure authentication for this card.

378282246310005

Not supported

3D Secure is not supported on this card and cannot be invoked. The PaymentIntent will proceed without performing authentication.

*All other Visa and Mastercard test cards do not require authentication from the customer's card issuer.* #### International test card numbers and tokens You can use any of the following test cards to simulate a successful payment for different billing countries. **For America**

 

NUMBER

COUNTRY

BRAND

4000000760000002

Brazil (BR)

Visa

4000001240000000

Canada (CA)

Visa

4012888888881881

Canada (CA)

Visa

4000004840000008

Mexico (MX)

Visa

#### For Europe, Middle East, and Africa

 

NUMBER

COUNTRY

BRAND

4000000400000008

Austria (AT)

Visa

4000000560000004

Belgium (BE)

Visa

4000002080000001

Denmark (DK)

Visa

4000002330000009

Estonia (EE)

Visa

4000002460000001

Finland (FI)

Visa

4000002500000003

France (FR)

Visa

4000002760000016

Germany (DE)

Visa

4000003000000030

Greece (GR)

Visa

4000003720000005

Ireland (IE)

Visa

4000003800000008

Italy (IT)

Visa

4000004280000005

Latvia (LV)

Visa

4000004400000000

Lithuania (LT)

Visa

4000004420000006

Luxembourg (LU)

Visa

4000005280000002

Netherlands (NL)

Visa

4000005780000007

Norway (NO)

Visa

4000006160000005

Poland (PL)

Visa

4000006200000007

Portugal (PT)

Visa

4000006430000009

Russian Federation (RU)

Visa

4000007240000007

Spain (ES)

Visa

4000007520000008

Sweden (SE)

Visa

4000007560000009

Switzerland (CH)

Visa

4000008260000000

United Kingdom (GB)

Visa

4000058260000005

United Kingdom (GB)

Visa (debit)

#### For Asia Pacific

 

NUMBER

COUNTRY

BRAND

4000000360000006

Australia (AU)

Visa

4000001560000002

China (CN)

Visa

4000003440000004

Hong Kong (HK)

Visa

4000003920000003

Japan (JP)

Visa

3530111333300000

Japan (JP)

JCB

4000004580000002

Malaysia (MY)

Visa

4000005540000008

New Zealand (NZ)

Visa

4000007020000003

Singapore (SG)

Visa

For other cases, please access more here.

For Admin​

  • Turn on/off 3D Secure
  • Set up the countries using the Payment Method
  • Specify Payment Action
  • Create Mobile or Telephone Order by the card information saved

How to Configure​

1. Configuration​

From the Admin panel, go to Stores > Configuration > Sales > Payment Method

1.1 Credential​

  • Environment:
    • Admin can choose Sandbox environment to test payment function with Stripe
    • When you want to apply for online payment, admin needs to change the environment to Production
  • Publishable key: Admin needs to register a Stripe Account to be able to use the payment methods that Stripe supports. Admin needs to correctly insert the Publishable key of your Stripe Account
  • Secret key: Comes with Publishable key, admin also need to fill in exactly Secret of Stripe Account
  • Test Credential button: Admin can check your app by clicking the Test Credential button

*How to create Stripe account and get API keys:**

  • Visit https://stripe.com to register a Stripe account. Then Sign In with the account you just registered successfully.
  • In the Dashboard page of Stripe, select Get your test API keys to get the API keys test for Sandbox Environment.
  • With the Production Environment, you need Activate account to get live API keys.

1.2 Card​

  • Enable: Select Yes so that Customer can pay by Card

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Credit Card Types:

    • Choose 1 or more cards for payment
    • Cards will be authenticated when customer completes the card number at check out. For cards not selected in this section, there will be an invalid message for the customer.

  • 3D Secure: Select Yes to use 3D Secure to verify Customer's card, thereby preventing payment fraud. Showing extra field Force using

  • Force Using: Select Yes to compulsorily verify the card. Showing additional field USing 3D secure when. Only successful 3D Secure verified cards can process orders

    • There are 5 types of cards that can be verified by 3D Secure:
      • Required: 3D Secure authentication must be completed for the payment to be successful
      • Recommended: 3D Secure is supported and recommended but not required on this card. Payments succeed whether 3D Secure is used or not.
      • Optional 1: 3D Secure is supported but not required on this card. 3D Secure authentication may still be performed, but is not required. Payments succeed whether 3D Secure is used or not
      • Optional 2: 3D Secure is supported for this card, but this card is not enrolled in 3D Secure. This means that if 3D Secure is invoked, the customer is not asked to authenticate. Payments succeed whether 3D Secure is invoked or not.
      • Not_supported: 3D Secure is not supported on this card and cannot be invoked.

  • Using 3D Secure When

    • 3D Secure is recommended: Force using 3D secure with recommended card type
    • 3D Secure is optional: Force using 3D secure with optional card type

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

1.3 Alipay​

  • Enable: Select Yes so that Customer can pay by Alipay

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

    1.4 Giropay​

  • Enable: Select Yes so that Customer can pay by Giropay

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

1.5. Bancontact​

  • Enable: Select Yes so that Customer can pay by Bancontact

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

1.6. Przelewy24​

  • Enable: Select Yes so that Customer can pay by Przelewy24

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

1.7. SOFORT​

  • Enable: Select Yes so that Customer can pay by SOFORT

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

1.8. EPS​

  • Enable: Select Yes so that Customer can pay by EPS

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

1.9. iDEAL Bank​

  • Enable: Select Yes so that Customer can pay by iDEAL Bank

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

1.10. Google Pay​

  • Enable: Select Yes so that Customer can pay by Google Pay

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

1.11. Apple Pay​

  • Enable: Select Yes so that Customer can pay by Apple Pay

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

    1.12. Microsoft Pay​

  • Enable: Select Yes so that Customer can pay by Microsoft Pay

  • Title: Enter the title of the payment method. This title will replace the name of the method to display in Frontend

  • Payment Action:

    • Authorize and Capture: Payment will be captured immediately after the Customer place order successfully. At that moment, customers' card is deducted for the order payemnt and the Invoice will be created.
    • Authorize: Payment will only be captured when admin creates Invoice for Customer's order. When the Invoice is successfully created, admin can receive money from Customer's card

  • Payment from Applicable Countries:

    • Select All Countries to allow Stripe payment method available in all countries
    • Select Specific Countries to limit certain countries to use this payment method
      • Payment from Specific Countries: The selected countries can show the Card payment method

  • Instruction: A simple description of this payment method. The instruction will be displayed at Frontend to instruct Customer how to use this payment method

  • Sort Order:

    • Choose display position of this payment method compared to other payment methods
    • 0 is the highest number

2. Admin create order at backend​

  • Go to Sales > Orders > Create New Order > Select Customer > Select Store.
  • After choosing product to make order, please fill the Address Information and choose Shipping Method. At Payment Method, choose Credit Cards(Stripe), then select one card which has been saved to process the payment.
  • Mageplaza Stripe extension only support admin to create backend order with the saved card information previously.

3. Frontend​

3.1. Stripe payment at checkout page​

3.2 Saved Card Management and Use Saved Card for Next Payment​