[UPDATED] PayPal Payment Gateway

Current Version: v2024-12-10 (release notes)

OpenCart Versions: 1.5.0.x - 4.0.2.x

To Purchase: Visit Clear Thinking or opencart.com



This extension allows you to accept payments in OpenCart via PayPal using their PayPal payment buttons. With this extension you can accept PayPal, Venmo, credit/debit cards and more, directly on your site. If you are using a multi-store OpenCart installation, the extension will also allow you to set different PayPal accounts for each store.

• Upload and go — no core file modifications are necessary.
• Take advantage of the built-in extension updater. All that's required is to enter your current license key and click "Update".
• Modify all front-end text directly in the admin panel.
• Restrict the payment method from appearing based on order total, store, geo zone, and customer group.
• Utilize both Sandbox and Live transaction modes.
• Refund, capture, and void payments directly from the OpenCart admin panel.
• Choose from various button stylings, including color, height/width, shape, and label text.
• Select which payment methods to accept within the admin panel, choosing from PayPal Credit, PayPal Pay Later, Credit/Debit Cards, Bancontact, BLIK, EPS, Giropay, iDEAL, Mercado Pago, MyBank, Przelewy24, SEPA, Sofort, and Venmo.
• Use different PayPal accounts for different stores in multi-store OpenCart installations.

Updated to v2023-4-18

Release Notes:
- Added: compatibility with OpenCart 4.0.2.x
- Added: ability to set the extension to authorize or capture payments
- Added: ability to authorize payments if potentially fraudulent, and capture otherwise (based on the OpenCart anti-fraud extensions installed)
- Added: ability to capture and refund payments from the transaction data in the order history
- Added: order status settings for Captured payments, Authorized payments, Fully Refunded payments, and Partially refunded payments

- Fixed: issue with loading the buttons in some currencies

- Updated: added better error display for payment errors
- Updated: products and line items are now sent to PayPal, so the invoice in PayPal will display a proper breakdown of all the OpenCart data

Updated to v2023-6-12

Release Notes:
- Added: compatibility with OpenCart 1.5.x (vQmod required)
- Added: new "Check For Updates" button with one-click update functionality
- Added: ability to map the currency the order is charged in

- Fixed: error when product names were over 127 characters
- Fixed: error when product models had apostrophes in them

- Removed: unnecessary debugging code

- Updated: code is now namespaced to avoid conflicting with other extensions
- Updated: included some code to address a particular OpenCart rounding bug

Updated to v2023-8-29

Release Notes:
- NOTE: This version fixes an important bug with calculating non-shipping and non-tax fees, so please update to this version ASAP.

- Added: ability to void authorized payments in the OpenCart order history
- Added: ability to capture payments multiple times

- Fixed: issues with the webhook key check
- Fixed: issues with non-shipping and non-tax fees
- Fixed: issues capturing payments for countries that use commas for decimals
- Fixed: the default capture amount was sometimes incorrect
- Fixed: error when the payment method was disabled on OpenCart 4.0.2.x
- Fixed: invalid webhook URLs in OpenCart 4.0.0.0 - 4.0.1.1

- Updated: the extension will no longer generate an error message when the store is set not to have any billing address or use the shipping address for the billing address in some OpenCart 4.0 versions
- Updated: captures and refunds will now update the order history immediately instead of relying on the webhook

Updated to v2023-10-26

Release Notes:
- NOTE: The webhook is no longer required as of this version. It can still be used if you want to update the order history in OpenCart when the capture/void/refund action is initiated from PayPal instead of OpenCart.

- Added: ability to set the alignment of the buttons (left, center, right)
- Added: ability to set Additional CSS in the extension admin panel
- Added: Testing Mode to record API requests and responses
- Added: the total uncaptured amount is now displayed in the order history data when a partial capture is performed

- Confirmed: 3D Secure 2.0 is supported by the javascript SDK being used

- Fixed: bug when using "Authorize if possibly fraudulent" setting
- Fixed: errors from the Rounding Adjustment not being forced to 2 decimals
- Fixed: error when product models were over 127 characters
- Fixed: error when telephone number was over 15 digits
- Fixed: 'Undefined array key "payment_buttons"' error
- Fixed: Payment Button checkboxes would check themselves when all unchecked

- Removed: "Initial" order status setting since it is no longer necessary

- Updated: PayPal logo image in OpenCart admin panel
- Updated: improved the error detection and display
- Updated: the payment source is now displayed in the order history
- Updated: the PayPal language is now set based on the language chosen by the customer in OpenCart

Updated to v2024-2-02

Release Notes:
- NOTE: You will need to reset your payment button choices after updating.

- Added: ability to manually set the localization value for each language
- Added: ability to set payment buttons individually for each store when using a multi-store installation

- Fixed: issue with using different PayPal accounts for multi-stores
- Fixed: multiple tax classes were not being counted correctly
- Fixed: capturing/refunding payments in non-default currencies wasn't working
- Fixed: issue with undefined "namespace" conflicts with other PayPal mods

- Updated: the currency for capturing/refunding payments is now displayed
- Updated: the extension now excludes some banned words from product names; if you find other words that cause issues please contact me

Updated to v2024-9-09

Release Notes:
- Added: improvements to the PayPal order creation function
- Added: improvements to some error messaging passed back from PayPal
- Added: default CSS to hide the Confirm Order button in Journal 3's checkout
- Added: PayPal email to the transaction data recorded in the order history
- Added: risk assessment score to the transaction data in the order history

- Fixed: occasional "Undefined index: seller_receivable_breakdown" error
- Fixed: "Undefined offset: 1" admin panel error in older OpenCart versions
- Fixed: the default locale was incorrect in older OpenCart versions

- Removed: Giropay since PayPal no longer supports that payment method
- Removed: Sofort since PayPal no longer supports that payment method

Updated to v2024-12-10

Release Notes:
- Fixed: a bug related to Order Totals that use the same internal codename
- Fixed: currency mapping issues

- Updated: buttons are now responsive for small screens
- Updated: alert banners unrelated to the extension will no longer be removed if they use the CSS "alert" class
- Updated: added some extra logging when the Access Token cannot be generated