[UPDATED] Stripe Payment Gateway Pro

Current Version: v2025-6-09 (release notes)

OpenCart Versions: 1.5.0.x - 4.1.0.x

To Purchase: Visit Clear Thinking or opencart.com



This extension allows you to accept payments in OpenCart via Stripe.com, the secure and easy way to accept credit cards online. The extension can send customer and card information to your Stripe account, allowing your customers to utilize their stored card information for future purchases, as well as subscribe customers to Stripe plans when purchasing certain products.

• Includes all the features of the standard Stripe Payment Gateway extension.
• Take advantage of the built-in extension updater. All that's required is to enter your current license key and click "Update".
• Supports the Stripe Payment Element and 3D Secure 2.0 to comply with SCA requirements.
• Supports Stripe Checkout, which is a Stripe-hosted, customizable payment page that accepts cards, Apple Pay, Google Pay, and dozens of regional payment methods, as well as allows subscriptions, promotion codes, and more.
• Add an Express Checkout button to your product, cart, and/or checkout pages. This lets customers purchase a product or their cart contents immediately (skipping the normal checkout) by using Apple Pay, Google Pay, Amazon Pay, Klarna, or Stripe Link. See a demo here: https://demo.getclearthinking.com/iphone
• Automatically displays alternate payment methods that you have set up in Stripe including Apple Pay, Google Pay, and Stripe Link. Support for region-specific payment methods includes ACH Direct Debit, Affirm, Afterpay/Clearpay, Alipay, Alma, Bacs Direct Debit, Bancontact, BECS Direct Debit, Billie, BLIK, Boleto, Capchase Pay, Cash App Pay, EPS, FPX, Grabpay, iDEAL, Klarna, Konbini, Kriya, MB WAY, MobilePay, Mondu, OXXO, P24, PayNow, PromptPay, Revolut Pay, SEPA Direct Debit, SeQura, Sunbit, WeChat Pay, Zip.
• Optionally add Stripe's Payment Method Messaging Element to your product pages by embedding a one-line script where you want the messaging to appear. See a demo here: https://demo.getclearthinking.com/macbook-pro
• Set additional order statuses for when the shipping and billing address do not match, as well for when Stripe Radar marks a transaction as having "elevated" or "highest" risk.
• Map OpenCart options and/or recurring profiles to Stripe subscription plans.
• Choose whether to add the shipping cost to a subscription when ordered by the customer.
• Allow customers to manage their cards and subscriptions through the Stripe Customer Portal.
• Create charges directly within the OpenCart admin panel.
• To inquire about upgrading and upgrade pricing, contact Clear Thinking.

Note: This extension requires that you have an SSL certificate installed on your site to securely process payment info.

Updated to v220.2

Release Notes:
- Added: ability to charge cards directly through the admin panel
- Added: ability to generate a payment link for customers, so they can pay an amount set by the admin, optionally attached to an order
- Fixed: "Undefined variable: error_warning" message on cards page
- Fixed: "Undefined variable: settings" error on cards page
- Fixed: products would not appear on future subscription orders if using option or recurring profile mappings
- Fixed: tax on shipping is sometimes charged separately


Release notes for the standard version can be found at viewtopic.php?f=124&t=53194&start=20#p620899

Updated to v230.1

Release Notes:
- NOTE: This version is fully compatible with OpenCart 2.3.0.x by using the OpenCart 2.3 Extension Compatibility Fix, which is provided for free with the purchase of the extension

- Added: support for Apple Pay!
- Fixed: new cards couldn't be added if the customer had not already stored one in Stripe
- Fixed: shipping for subscriptions was being taxed twice, due to how Stripe handles tax on invoices
- Fixed: admin Charge Card functionality wasn't working properly
- Updated: multiple subscriptions are now possible if multiple options or recurring profiles on a single product are associated with different plans


Release notes for the standard version can be found at viewtopic.php?f=124&t=53194&start=20#p642732

Updated to v230.2

Release Notes:
- Added: "Statement Descriptor" field to the admin Create a Charge tab
- Fixed: due to the fix for multiple subscriptions added in v230.1, option and recurring profile mappings weren't overriding the plan ID in the Location field for the product
- Fixed: multiple buttons being added to the end of checkout when Apple Pay is enabled
- Fixed: "[Object object]" error messages for admin Create a Charge tab


Release notes for the standard version can be found at viewtopic.php?f=124&t=53194&start=20#p652270

Updated to v230.3

Release Notes:
- Added: ability to select the currency for the transaction in the Create a Charge tab
- Added: ability to change the order status when charging a card in the Create a Charge tab
- Fixed: JPY values in the Apple Pay sheet were not being displayed correctly


Release notes for the standard version can be found at viewtopic.php?f=124&t=53194&p=655436#p655436

Updated to v230.4

Release Notes:
- Fixed: errors caused on the payment page when using the Create a Charge tab when Apple Pay is enabled
- Fixed: issues caused on the Cards page by mods that add blank data to all server requests
- Updated: Create a Charge tab now uses Stripe Elements

Standard Version Release Notes:
- NOTE: This version now uses Stripe Elements, the new way Stripe provides for styling the credit card inputs. This is more secure, and replace the standard inputs from previous versions. This DOES NOT work with Apple Pay yet, so if you need Apple Pay support then do not update at this time.
- Fixed: refunds occasionally being $0.01 off due to a bug in PHP int casting
- Removed: "Card Name" field, since that should be taken from the billing address anyway
- Updated: added a few styling edits for compatibility with quick checkouts
- Updated: the Stripe Event ID is now recorded when a webhook creates an order in OpenCart

Updated to v300.1

Due to limitations in the opencart.com license system, a new extension was released on opencart.com for OpenCart 3.0 compatibility. However, free updates are still available for anyone that has purchased the extension in July 2016 or after --- just contact Clear Thinking here: http://www.getclearthinking.com/contact

Release Notes:
- NOTE: Due to a change in function names, orders placed before this version will not be able to be captured or refunded in the order history area. If you need to do these actions, you can so in your Stripe admin panel.

- NOTE: Don't forget to update your webhook URLs in your Stripe admin panel, as the extension directory path has changed from previous versions.

- NOTE: Due to OpenCart 3 requirements, the cards/subscriptions page URL and the webhook URL have been changed. Don't forget to update both these things wherever you have placed them.

- Added: compatibility with OpenCart 3.0.0.x
- Added: native compatibility with OpenCart 2.3.0.x (You can remove the compatibility fix, or keep using it if you want to)
- Removed: compatibility with OpenCart 1.5.x and 2.0.0.0 for new versions
- Removed: text settings no longer needed because of Stripe Elements
- Updated: installation no longer requires the base version be installed first

Updated to v302.1

Release Notes:
- NOTE: Starting with this version, all template files will use the .twig extension. These will still work completely fine on OpenCart 2.x versions, and still use the .tpl-type syntax. However, if you've made edits to the .tpl file, you'll need to port those edits over to the new file.

- Added: support for 3D Secure

- Confirmed: compatibility with OpenCart 3.0.2.x

- Fixed: errors when subscription orders are created using webhook data
- Fixed: credit card inputs are too wide on mobile devices with small screens
- Fixed: custom error messages weren't always being displayed
- Fixed: empty stored card info could appear if the customer existed, but had no default card attached to them
- Fixed: shipping wasn't getting passed to subscriptions if there was no trial period on the first order

- Updated: card payments are now made as a Stripe "source" instead of "token"

Updated to v302.2

Release Notes:
- Added: ability to choose whether to always send receipt e-mails from Stripe
- Added: support for the new Payment Request Button, which will let you accept Apple Pay, Android Pay, and any browser-stored cards that use the payment request API for browsers (currently only supported by Chrome)

- Fixed: Stripe accounts with more than 100 plans not showing those in the OpenCart admin panel
- Fixed: webhook issue with mismatching zone name/code
- Fixed: orders that were exactly 0.50 were not getting charged properly
- Fixed: the quick checkout embed using Stripe Checkout wasn't working correctly since the pop-up no longer collects the state/region

- Updated: made the quick checkout postcode check for shipping ignore spaces and letter case

Updated to v302.3

Release Notes:
- Added: order statuses are now changed when a charge is captured

- Fixed: stopped useless guest customer mappings being saved to the database
- Fixed: recurring profile mappings were not working in OpenCart 2.0-2.2
- Fixed: "Undefined index: token" error on the payment link page
- Fixed: 3D Secure not working when "Send Customer Data" was set to "Always"

- Removed: functionality for Bitcoin because Stripe has stopped supporting it
- Removed: functionality for Alipay because Stripe has stopped supporting it within Stripe Checkout

- Updated: the shipping address on orders created by webhooks will now be the customer's default address in OpenCart, so it can be updated if necessary
- Updated: added a fix for Journal checkout causing "owner[name]" errors
- Updated: added some more styling fixes for CSS messed up by Journal

Updated to v302.4

Release Notes:
- NOTE: Don't forget to click "Save" after updating to this update, since there are some new settings that need to be saved.

- Added: support for Alipay, Bancontact, EPS, Giropay, iDEAL, and P24! (Note: I do not have my own accounts to test these new payment methods, so if you have issues with any of them, please contact me and I can take a look at your store)

- Added: ability to set order status if mismatching billing/shipping addresses
- Added: ability to partially capture a payment (note: only new orders will be able to be captured, so make sure you capture old orders before installing the update)

- Updated: admin users now need "Modify" permission in order to capture or refund charges in the order history area
- Updated: "Browser/Android Pay" has been renamed to "Google Pay"
- Updated: Apple Pay and Google Pay are now part of the "Other Payment Methods" tab, along with the new payment methods mentioned above

Updated to v302.5

Release Notes:
- NOTE: This version uses the latest API version and has some major changes related to subscriptions, so if you are using those make sure you can test this new version when you have time to address potential issues. If you do notice any irregular or problematic behavior after updating, please contact me at http://www.getclearthinking.com/contact

- Added: ability to set a Start Date for subscriptions mapped to options or recurring profiles
- Added: ability to set order statuses for payments that fail Stripe Radar's assessment (for "Elevated" and "Highest" results)

- Fixed: issues with the order editor from v302.4
- Fixed: cookie problems rarely causing 3D Secure not to verify properly
- Fixed: Stripe Checkout is no longer enabled by default
- Fixed: Stripe Checkout is no longer loaded if enabled and someone chooses a different payment method
- Fixed: the payment method name now uses the extension heading if it's a normal card payment

- Updated: all requests are now made using Stripe API version 2018-05-21
- Updated: Stripe Checkout can now be used along with other payment methods
- Updated: added a work-around for the "invalid email address" error caused by third party checkouts
- Updated: orders created by webhooks for subscriptions mapped to options or recurring profiles will now show the correct product name + option/profile
- Updated: Apple Pay now only shows if the browser is Safari
- Updated: Google Pay now only shows if the browser is Chrome
- Updated: Alipay now only shows if the currency qualifies for Alipay

Updated to v302.6

Release Notes:
- Fixed: guests were not allowed to purchase non-subscription products if "Prevent Guests" was turned on for subscription products
- Fixed: "Undefined variable: payment_type" error
- Fixed: product names from older subscriptions were not showing up correctly
- Fixed: shipping costs were not being added to the initial subscription
- Fixed: "Create Charge" links weren't working correctly from the last update
- Updated: added some additional styling for things messed up by Journal 3

Updated to v303.1

Release Notes:
- Confirmed: compatibility with OpenCart 3.0.3.x

- Fixed: Stripe Checkout setting wasn't holding
- Fixed: webhook orders were not creating the correct address
- Fixed: error message when no valid zone or country is set for a customer address and a subscription webhook order is attempted to be created
- Fixed: issues with non-card payment methods on multi-store installations
- Fixed: subscriptions using the product Location field weren't always working

- Updated: filepath in the last step of the instructions.txt file
- Updated: 3D Secure is now off by default, since having it on wasn't intended

Updated to v302.2

Release Notes:
- MAJOR RELEASE: This release is a major update to comply with new SCA regulations in Europe, including support for 3D Secure 2.0. Please read the following update notes carefully, and the rest of the normal release notes below that.

- NOTE: The 1.5.x version is now feature-comparable with the 2.x/3.x version. The extension uses a vQmod file to accomplish this, which has been tested but might have some issues in the initial version. If you're using OpenCart 1.5.x and have any trouble with it, please contact Clear Thinking.

- NOTE: Customers' stored cards will not show up until they are re-added after this update. This has to do with how the underlying data representing them has changed, and will help ensure the customer has to validate their card for 3D Secure if they want to store it again. Similarly, any orders placed prior to installing this update will NOT be capturable or refundable in OpenCart. Make sure you capture/refund old orders BEFORE updating.

- NOTE: The previous version used javascript to render the different payment methods (like Apple Pay or Google Pay) as their own radio button during checkout. This caused issues with many quick checkouts, so I've removed it and have switched to using tabs in the payment area. Customers can choose from among the enabled payment methods in that area, but multiple radio buttons are not an option due to the way OpenCart works.

- NOTE: A lot of the work in this version involved subscriptions because they are so complicated. If you're using subscriptions in your store, there may be issues during the transition from the old version to the new version. Please contact me if you see any issues with subscriptions after updating.

- NOTE: The old pop-up version of Stripe Checkout has been discontinued, and removed from the extension. I'll be adding support for the new Checkout as Stripe updates it and adds some features necessary for OpenCart stores.

- NOTE: The "Create a Charge" tab now uses the new Stripe Checkout to complete the payment. Currently you can't use a customer's stored cards, but as Stripe Checkout is updated you'll be able to use any Checkout features for the payment.

------------------------------------------------------------------------------

- Added: full compatiblity with OpenCart 1.5.x again
- Added: 3D Secure is now always enabled, due to SCA requirements
- Added: a webhook is now automatically created when the admin panel is loaded
- Added: ability to set different "Please wait" messages for each step of the payment process
- Added: ability to choose whether the OpenCart address or the Stripe address is used for orders created by subscriptions
- Added: ability to set payment icons for the various payment types
- Added: if stored cards are allowed to be used, the customer can now choose from any of their stored cards during checkout, and can set the chosen card to be their default if they want

- Fixed: purchasing multiple subscriptions would only show the first one in the order history area
- Fixed: shipping for non-trial subscriptions will now be deleted when cancelling the subscription in the OpenCart cards/subscriptions area
- Fixed: Apple Pay still showed up in Chrome on iPhones because it uses a different user agent than desktop Chrome

- Removed: lots of old settings that no longer applied
- Removed: "quick checkout" ability by embedding the old Stripe Checkout, since it has been deprecated

- Updated: all requests are now made using Stripe API version 2019-03-14
- Updated: widened the Stripe Elements form, so the card icon and CVC field would appear
- Updated: customer mappings are now deleted if the customer is deleted in Stripe, to avoid errors if that customers tries to purchase again
- Updated: product data on a subscription will now be pulled from OpenCart if the product_id exists in the metadata for the subscription
- Updated: if the original order ID exists in the metadata for a subscription it will be shown on the created subscription order
- Updated: changed the subscriptions listing page so that if subscriptions aren't cancellable, it still shows subscriptions but hides the Cancel button

Updated to v303.3

Release Notes:
- Added: appInfo to all API requests, so Stripe knows the source info
- Added: support for Microsoft Pay
- Added: support for Visa Checkout
- Added: support for WeChat Pay

- Fixed: multiple e-mails being sent out due to charge.captured webhooks
- Fixed: refund data would be added to the wrong order if the payment_intent on the transaction was blank (e.g. from refunding an old order)
- Fixed: cards not tokenized as "paymentMethods" were still showing up to use as stored cards, but wouldn't work when processing them
- Fixed: declined cards used for subscriptions were not giving the right error
- Fixed: "Undefined variable: payment_methods" error on the stored cards page

- Updated: all the curlRequest() functions are now consolidated into a single function, to avoid a bunch of duplicate code
- Updated: the "Payment Sheet Label" setting for Apple Pay / Google Pay has been removed, and it is now set automatically based on the store's URL (which means it works better with multi-store installations)
- Updated: the Apple Pay, Google Pay, and Microsoft Pay tabs will now be hidden if the customer doesn't have an eligible card to use in their browser

Updated to v303.4

Release Notes:
- Added: support for Masterpass
- Added: ability to display card inputs as individual fields
- Added: ability to limit a subscription to a certain number of cycles

- Fixed: using "Authorize if possibly fraudulent" wasn't defaulting to capture
- Fixed: a few OpenCart 1.5-specific bugs related to the vQmod file

- Updated: the payment type is now recorded in the order comments
- Updated: payment method names are now hidden on mobile devices so just the images will show, letting the tabs fit on one line
- Updated: if using a quick checkout that does not properly create the order before loading the payment method like it should, then order info will now be filled in as blank (with the exception of the order total, which is calculated based on the Order Total extensions)

Updated to v303.5

Release Notes:
- Added: card decline data is now recorded in the order history
- Added: ability to set order status based on transactions placed "in manual review" by Stripe Radar

- Fixed: one more OpenCart 1.5-specific bug related to the vQmod file
- Fixed: customers could get stored in Stripe with the incorrect e-mail address if any guests were stored in the mapping database table

- Updated: changed default order status for "Successful Payment (Authorized)"
- Updated: adjusted some code to fix reloading issues caused by Journal 3
- Updated: code for loading the address when it's missing is now improved to fix quick checkout errors related to "billing_details[address]"

Updated to v303.6

Release Notes:
- NOTE: This version features a new method of connecting with Stripe, using Stripe Connect instead of manually entering API keys. This should help make the extension more secure and easier to set up, as well as provide Clear Thinking with limited transaction information I can use to help debug issues (without having to give me any Stripe account access). After installing this update, you'll need to reconnect your Stripe account with the extension, which you can do in the "Stripe Settings" tab of the extension admin panel.

Just to be clear, Clear Thinking will NOT have access to any of your Stripe data beyond that limited transaction information, and that will be used SOLELY to assist in debugging issues. No transaction data is collected by or sent to Clear Thinking. If you have any questions, please contact me.

- Added: new method of connecting the extension to Stripe
- Added: "Delete Card" button to the "Use a Stored Card" tab, so saved cards can be deleted directly in the checkout

- Fixed: "Undefined variable: language" error when the extension is set to prevent guests from purchasing subscription products
- Fixed: "Undefined index: code" and "Undefined index: payment_intent" errors when problems occur with non-card payment methods
- Fixed: error with non-card payment methods stating that they "can only be used with PaymentIntents that have capture_method=automatic"

- Updated: front-end styling with some improvements
- Updated: changed some code slightly to address issues caused by some quick checkouts where multiple customer accounts were created in Stripe
- Updated: authorized transactions can now be cancelled by using the "Refund" link in the order history
- Updated: WeChat Pay payments can now be authorized (or failed) in Test mode

Updated to v303.7

Release Notes:
- NOTE: If you're updating from a version older than v303.6, please read the release notes for v303.6 below, because they are still important.

- NOTE: To enable Apple Pay, all you need to do now is enable it in your Stripe account. You do not need to add your domain, the extension will automaticaly do that for you when connecting the extension to your Stripe account. The Stripe "domain association file" will also now be uploaded to your server when doing the connection process. If you have any trouble with Apple Pay in this version, please contact me.

- Added: "Webhook" setting back into the admin panel, because auto-creating the webhook no longer works due to the Stripe Connect change
- Added: ability to deny all payment attempts from a customer after a certain number of failed tries
- Added: option to turn off the advanced error handling used to catch errors outside the extension (which has issues with some quick checkouts)
- Added: line items from the OpenCart order are now shown in the Apple Pay, Google Pay, and Microsoft Pay pop-ups
- Added: preliminary support for Multibanco (contact me if you have issues)

- Fixed: the Partial Refund Status wasn't working when set to "--- Ignore ---"