[UPDATED] Stripe Payment Gateway Pro

Updated to v303.8

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.

- Added: support for Stripe Checkout
- Added: transaction fee amount, exchange rate, and converted payment amount to the transaction data recorded on the order
- Added: payment request buttons are now limited to qualifying countries
- Added: "Cancel" button for WeChat Pay displayed once the QR code is shown

- Fixed: "Undefined index: card_id" on the front-end
- Fixed: "Undefined index: account_id" in the admin panel after updating
- Fixed: currency mappings were not working correctly
- Fixed: "You passed an empty string for 'customer'" error for subscriptions
- Fixed: Multibanco payments would occasionally get assigned their Initial order status after completing payment, instead of the successful status
- Fixed: "Undefined index: transaction_mode" and "Undefined index: _publishable_key" errors when first loading the extension admin panel
- Fixed: line items in Apple Pay, Google Pay, and Microsoft Pay pop-ups were not correct for non-default currencies

- Updated: improved order information that is filled in when using quick checkouts that don't properly create the order first
- Updated: moved order data sanitization into the controller file, and added some additional replacements for characters that shouldn't be in addresses
- Updated: subscriptions that charge immediately but have a webhook that fails will no longer create an order after the webhook is retried by Stripe
- Updated: off-site payment types (like Alipay) now have some default instructions filled in indicating the customer needs to confirm the order
- Updated: adjusted the URL format for non-card payment methods so that it works better with stores using mods that change the checkout page URL
- Updated: currency checks for non-card payment methods will now use the currency mappings set in the extension

Updated to v303.9

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.

- Added: support for SEPA Direct Debit
- Added: ability to send an e-mail to administrators when a delayed payment like SEPA is completed successfully or when it fails
- Added: an "Initial Order Status" setting that controls the initial status assigned to Stripe Checkout, Multibanco, and SEPA Direct Debit orders

- Fixed: currency conversion display in the order history was not correct for zero-decimal currencies
- Fixed: "trying to access array offset" error for PHP 7.4
- Fixed: "Undefined index: stripe_checkout" error on older OpenCart versions
- Fixed: shipping for subscriptions was sometimes not added correctly
- Fixed: cycles for subscriptions weren't working due to a change in Stripe's data format
- Fixed: apostrophes were not being escaped for Stripe Checkout errors
- Fixed: recurring profile / option mappings didn't work with Stripe Checkout

- Updated: unneeded functions are now hidden if Advanced Error Handling is turned off
- Updated: added a better format for the non-card payment method return URL
- Updated: Stripe does not allow 0.00 line items in Stripe Checkout, so those are no longer passed to Stripe when Stripe Checkout is enabled
- Updated: Stripe Checkout orders will now be assigned an initial order status in case the webhook does not complete the order for some reason

Updated to v303.10

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.

- Added: "Risk Level" to the order history data
- Added: ability to limit subscription mappings based on currency
- Added: ability to pause and unpause subscriptions (make sure you read the note about the "Delete Confirmation" setting below)
- Added: admin is now notified via e-mail when a subscription is canceled, with a simple e-mail containing the order number, product name, and customer

- Fixed: connection issues caused by browser HTTP_REFERER restrictions
- Fixed: tax rates were not being set correctly for 0-decimal currencies
- Fixed: rare currency conversion issue on installations upgraded from older OpenCart versions which had duplicate currency settings in the database
- Fixed: "Cancel" button text on cards/subscriptions page was hard-coded
- Fixed: images with non-ASCII characters weren't working with Stripe Checkout
- Fixed: "Can't use method return value in write context" error related to Stripe Checkout in certain rare circumstances
- Fixed: 0-decimal currency subscriptions were not displaying correctly on the subscriptions page

- Updated: the "Delete Confirmation" setting for the cards/subscriptions page is now a general confirmation message, so it will need to be updated if you using that setting
- Updated: Stripe now supports Alipay and SEPA for Stripe Checkout
- Updated: option/profile mappings will now ignore whitespace at the beginning and end of the option/profile name, to avoid errors due to mistaken spaces
- Updated: added some help text for Alipay and WeChat Pay to explain that Stripe limits them to only mainland China bank accounts
- Updated: costs on the subscriptions page now include tax if present

Updated to v303.11

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.

- Added: support for Sofort (I can't fully test this, so if you try it out and have any issues, please contact me and I can help you sort them out)
- Added: ability to require the full billing address in Stripe Checkout

- Fixed: "Trying to access array offset on value of type null" error in 1.5.x
- Fixed: issues with performing a refund with a 0-decimal currency
- Fixed: issues with performing a capture with a 0-decimal currency
- Fixed: an unnecessary "PaymentIntent confirm" call will no longer happen for subscriptions that do not need to be confirmed via 3D Secure
- Fixed: currency conversion issues could cause a payment not to be captured
- Fixed: mapped coupons occasionally had calculation issues
- Fixed: incorrect Stripe Checkout line item values for non-default currencies

- Updated: resolved initial connection issues due to recent updates in Chrome
- Updated: the "handleCardPayment" function was deprecated by Stripe, so it has been renamed to the current "confirmCardPayment" function
- Updated: all non-card payment methods now use webhooks to complete the order, to help with customers that do not return to OpenCart after payment

Updated to v303.12

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.

- New Payment Method: Afterpay/Clearpay
- New Payment Method: Klarna
- New Payment Method: Secure Remote Commerce (this replaces Masterpass and Visa Checkout, so if you were using those, make sure you set this up again)

- Added: the Stripe "account_id" is now shown in the "Connected" text
- Added: a subscription order report in the Subscription Products tab, which will display a list of all orders that contained subscription products
- Added: payment_method, payment_code, shipping_method, and shipping_code fields are now filled in for orders created via the webhook URL
- Added: better handling of errors that occur after the payment is successful, so they don't stop the order from completing
- Added: [Stripe Checkout] Instructions field

- Fixed: duplicate webhooks for the same event should no longer create duplicate orders in OpenCart
- Fixed: old subscriptions without the "order_id" metadata could end up not creating the order via webhook if multiple subscription webhooks were sent by Stripe at the same time
- Fixed: "Undefined index: currencies" error when the OpenCart store does not have the currency set up that the Stripe account uses
- Fixed: coupons applied to subscriptions weren't being shown in the OpenCart order created via the webhook
- Fixed: [Stripe Checkout] gift vouchers weren't being sent
- Fixed: [Stripe Checkout] issue with blank product images when using Stripe
- Fixed: [Stripe Checkout] SEPA Debit was not working properly

- Updated: products sent to Stripe should now have the options and profiles from the original order added into the product name, so they're visible on the subsequent orders created via the webhook
- Updated: orders created via webhook will now use the latest customer address if they don't have any default address set for some reason
- Updated: the Apple Pay domain association file will no longer be created if it already exists, to stop it from uploading a 0KB file on some servers
- Updated: based on user feedback, the subscription pausing parameter is now "void" instead of "keep_as_draft"
- Updated: the "Shipping for..." line item on subscription orders will now default to "Shipping for Subscription" if no Pricing Plan Description is set
- Updated: [Stripe Checkout] the "Address Mismatch" order status will now also be applied if the address used in Stripe Checkout doesn't match the one used in OpenCart

Updated to v303.13

Release Notes:
- NOTE: This version should solve some issues with attaching shipping costs to subscriptions. They will now always be added to the subscription object, instead of the customer object. If you notice any issues with subscriptions after updating to this version, please contact Clear Thiking.

- New Payment Method: FPX

- Added: ability to utilize the payment "Terms" field in OpenCart 2 and 3, which are displayed next to the extension title in ( and ) brackets
- Added: ability to use the original order's shipping address for new orders created when subscriptions are charged in Stripe. Additionally, the "Subscription Order Address" setting now only affects the new order's shipping address (since the billing address should always be the address associated with the card used for payment in Stripe).
- Added: ability to set the cancel & return URLs when using "Create a Charge"
- Added: beta support for merging subscription products into one invoice when they are purchased at the same time

- Fixed: attempted storing of cards for guest customers
- Fixed: exchange rate was off for 2-decimal currencies
- Fixed: "Undefined offset: 0" notice related to confirming PaymentIntents
- Fixed: webhooks that did not complete right away would trigger another webhook from Stripe, even if it did complete successfully
- Fixed: issues with Klarna when product names have an apostrophe in them
- Fixed: "Trying to access array offset" error on newer PHP versions
- Fixed: WeChat Pay issue on multi-store OpenCart 1.5 installations
- Fixed: "Undefined index: order_id" and "currencies_" errors when an invoice in Stripe uses a source-based payment method
- Fixed: Sofort orders would get completed via the webhook too early
- Fixed: $0.00 trial end invoices will no longer create an order in OpenCart
- Fixed: subscriptions in non-default currencies could display incorrectly on the Cards/Subscriptions page
- Fixed: [Stripe Checkout] "Undefined index: payment_method" error
- Fixed: [Stripe Checkout] subscriptions weren't working correctly if "Include Shipping" was enabled
- Fixed: [Stripe Checkout] manually visiting the completion URL could complete the order

- Updated: added some styling for the Individual fields option
- Updated: card details are now shown in the order history for subscriptions
- Updated: the Stripe Payment ID now links to the Stripe web page for that ID
- Updated: as required by the API, telephone values are now limited to 20 characters and will ignore characters beyond that
- Updated: failed Afterpay payments no longer complete the order in OpenCart
- Updated: eligible currencies for Alipay

Updated to v303.14

Release Notes:
- Added: Idempotency Keys to API requests, to avoid duplicate payment issues caused by other modifications
- Added: ability to send a daily e-mail to store administrators with a list of currently uncaptured payments and when they will expire
- Added: the Charge Mode setting "Authorize if possibly fraudulent, Capture otherwise" will now authorize the charge if the Stripe Radar risk assessment gives a "Review" recommendation or a risk level of "Highest"
- Added: [Stripe Checkout] support for WeChat Pay

- Fixed: "Undefined index: card" error when the curl API call fails
- Fixed: orders created by subscriptions were not correctly using the product name with options that was in the subscription metadata
- Fixed: orders created by subscription webhooks were using the country code instead of the country name
- Fixed: error when creating a new card in the Cards & Subscriptions page if the customer had never made a payment before
- Fixed: a bug with the new "Merge Subscriptions" setting
- Fixed: [Stripe Checkout] product images containing certain special characters would cause and Invalid URL error
- Fixed: [Stripe Checkout] starting a session and then turning off Stripe Checkout to try a normal payment would result in a "Checkout session" error
- Fixed: [Stripe Checkout] errors in the checkout session API request would cause an "Undefined variable: checkout_session_id" error

- Updated: the PaymentIntent ID should now be recorded on orders created by subscription charges via the webhook, instead of the Charge ID
- Updated: the PaymentIntent description for orders created by subscription charges will now be updated according to the Transaction Description setting
- Updated: order statuses set by Anti-Fraud extensions will now override the "Successful Payment (Authorized)" order status if present

Updated to v303.15

Release Notes:
- Added: "Additional CSS" field to set custom CSS directly in the admin panel
- Added: a button that allows the user to reconnect Apple Pay without being required to reconnect the entire extension
- Added: ability to transfer all customers on a particular Pricing Plan to a different Pricing Plan
- Added: [Stripe Checkout] support for Klarna
- Added: [Stripe Checkout] ability to require a phone number
- Added: [Stripe Checkout] additional webhooks for multi-store installations

- Fixed: potential issues with createOrder() method in the model file
- Fixed: issues with coupons applied to multiple subscriptions in one order
- Fixed: coupons applied to subscriptions weren't being recorded in the OpenCart coupon history report
- Fixed: loading issue when WeChat Pay instructions contained an apostrophe
- Fixed: "Undefined variable: payment_intent" error related to SRC
- Fixed: issues related to the "Merge Subscriptions" setting
- Fixed: [Stripe Checkout] extension currency mappings were not working
- Fixed: [Stripe Checkout] in multi-store installations, OpenCart would sometimes send the order confirmation e-mail from the wrong store

- Updated: the Refund ID is now in the transaction data recorded for refunds
- Updated: the webhook URL is no longer unnecessarily saved to the database
- Updated: metadata now supports 500 characters per entry
- Updated: the e-mail listing uncaptured payments will now ignore payments made in the last hour, to avoid including payments-in-process
- Updated: added a fix for Journal checkout's bug where the loading overlay does not get removed after a payment error
- Updated: the Apple Pay domain association file is now downloaded via curl
- Updated: Apple Pay domains are now deleted before creating them in Stripe, which should help reduce issues with Apple Pay not showing up sometimes
- Updated: the payment link created by "Create a Charge" should now show the alternate payment methods enabled in the extension (if Stripe Checkout supports them, and the customer's currency/location qualifies for them)
- Updated: metadata for subscriptions when not using "Merge Subscriptions" will now display the product_id and product_name like it used to

Updated to v303.16

Release Notes:
- NOTE: This version updates the API version in the curl requests to Stripe's latest API version (2020-08-27). This required some changes to subscription objects, so if you notice any issues after updating, please contact me.

- Added: ability to notify the administrator when a payment is declined with the decline code "fraudulent"
- Added: "Quick Buy" button you can place on product pages and the cart page, allowing customers to quickly purchase their items using Stripe Checkout, skipping the normal checkout process

- Fixed: HTML wasn't working in the individual card field text strings
- Fixed: rare issue with some browsers caching the completeOrder() call
- Fixed: Klarna errors related to unsupported countries or currencies
- Fixed: [Stripe Checkout] errors when order information was not present
- Fixed: [Stripe Checkout] "Invalid boolean: 1" error when requiring telephone
- Fixed: [Stripe Checkout] taxes not being included for subscription products

- Updated: Stripe API version to the latest (2020-08-27)
- Updated: curl PHP version to the latest (7.114.0) for "user_agent" value
- Updated: 3D Secure comment info to show more info
- Updated: "tax_percent" parameter changed to "default_tax_rates" parameter
- Updated: created a manual method to display the API information when connecting, for servers that cut off long URLs --- contact me for info on how to use this if you are experiencing this issue
- Updated: failed Afterpay, SEPA, and Sofort payments will no longer change the order status if the order had a secondary successful payment
- Updated: [Stripe Checkout] ngrok URLs will now work for webhooks
- Updated: [Stripe Checkout] code improvements so that Checkout sessions are not created until the Confirm Order button is clicked
- Updated: [Stripe Checkout] compatibility improvements for quick checkouts that do not properly create the order before loading the payment method

Updated to v2022-6-28

Release Notes:
- NOTE: This version replaces the payment inputs with Stripe's new Payment Element. This helps process non-card payment methods with less code, and will make adding support for new methods in the future much easier. If you experience any issues with the Payment Element, please contact me.

- WARNING: Card storage does not currently work in the Payment Element. This is planned to be added by Stripe toward the end of 2022.

- New Payment Method: ACH Direct Debit (instant verification only for now)
- New Payment Method: Affirm
- New Payment Method: BECS Direct Debit
- New Payment Method: Boleto
- New Payment Method: Grabpay
- New Payment Method: Konbini
- New Payment Method: OXXO
- New Payment Method: PayNow

- Added: compatibility with OpenCart 4.0.0.x
- Added: speed improvements related to the the uncaptured payments e-mail
- Added: ability to switch the Payment Form Theme in the admin panel
- Added: card/subscription management has now been moved to using Stripe's Customer Portal, which should offer more functionality going forward

- Fixed: error when trying to connect servers that don't set the HTTP_REFERER
- Fixed: subscriptions weren't working with the Quick Buy button
- Fixed: [Stripe Checkout] tax-related issues when using and purchasing subscriptions in a currency different than the store's default currency

- Removed: all settings that are no longer necessary
- Removed: support for Multibanco and Secure Remote Commerce (because the Payment Element doesn't support those two payment methods yet)

- Updated: an informational quick start pop-up will now show up when first installing the extension
- Updated: orders will now be updated to the "Order Completion Error" status if a subscription is created with a valid card, but the payment fails immediately for some reason (like insufficient funds)
- Updated: non-card payment methods can now be managed solely in Stripe, and do not require enabling or customizing anything in the extension itself

Updated to v2022-9-07

Release Notes:
- New Payment Method: Stripe Link
- New Payment Method: Bacs Direct Debit

- Added: compatibility between subscriptions and Clear Thinking extensions that are calculate tax

- Confirmed: compatibility with OpenCart 4.0.1.x

- Fixed: issues with using a template file in a non-default theme directory
- Fixed: the amount displayed on second partial refunds was incorrect
- Fixed: sequential refunds for the same amount were not working
- Fixed: a bug causing duplicate order e-mails due to subscription failures
- Fixed: OpenCart 4.0-specific issues with recurring profiles / subscriptions
- Fixed: the webhook wasn't updating the order status for Klarna payments
- Fixed: [Stripe Checkout] errors generated in the OpenCart error log when non-OpenCart payments were made and the webhook received the event data

- Updated: Stripe API version to the latest (2022-08-01)
- Updated: curl PHP version to the latest (9.3.0) for "user_agent" value
- Updated: reloading the page will now automatically select the same tab
- Updated: the admin will now get an e-mail if a subscription payment fails
- Updated: the "Cards & Subscriptions" page was restored in this version, because the Stripe Customer Portal now has a cost associated with using it
- Updated: a customer is now created in Stripe if they visit the "Cards & Subscriptions" page without already having a Stripe customer object, and they can add a new card even if they have never stored one before
- Updated: API syntax for the "Create a Charge" function

Updated to v2022-11-28

Release Notes:
- Added: ability to connect the extension to Stripe manually if the normal connection process fails because of server issues
- Added: ability to use a [name] shortcode in the transaction description

- Fixed: 4.0-specific bug with the return URL when connecting to Stripe
- Fixed: duplicate orders could be created if a 3D Secure verification failed on a subscription purchase
- Fixed: the PaymentIntent ID was not properly updated when the checkout was loaded first with subscription products then with non-subscription products
- Fixed: the payment form was always loaded as Simplified Chinese if the language code started with "zh"
- Fixed: errors generated via the webhook for certain non-card payment methods when using the same Stripe account on a separate non-OpenCart site

- Updated: added some styling for Journal's two-step pop-up to make it wider
- Updated: server unavailable errors will now trigger the normal error alert, rather than the "fatal error" message
- Updated: Afterpay payments no longer use the webhook to confirm the order
- Updated: Klarna payments no longer use the webhook to confirm the order
- Updated: P24 payments now use the webhook to confirm the order
- Updated: metadata is now set when the initial PaymentIntent is created, so it will be visible to provide more info on "Incomplete" transactions

Updated to v2023-2-22

Release Notes:
- NOTE: All non-card payment methods have been changed to use the webhook to finalize the transaction and display the information in the order history. This should help when customers close their browser window too early or are otherwise interrupted from seeing the normal "checkout/success" page, but make sure you have entered the webhook from the extension into your Stripe admin panel in Developers > Webhooks (in both Test and Live mode).

- Added: option to use the Accordion display of the Payment Element
- Added: option to collapse the display of the initial payment choice
- Added: support for three-decimal currencies (BHD, JOD, KWD, OMR, TND)
- Added: ability to limit pausing subscriptions to a number of weeks
- Added: more descriptive error information for failed non-card payments
- Added: number of cycles left to the customer subscription information page

- Fixed: "connecting manually" link color on OpenCart 4.0 versions
- Fixed: issues with blank product and address info when a very old subscription created a new order in the latest version
- Fixed: "Undefined index: client_secret" warning when the PaymentIntent could not be created for various reasons

- Updated: improved the connection process when HTTP_REFERER is not set
- Updated: orders created by subscriptions that have cycles now show the cycles remaining in the order history info