Resolving OpenCart Mollie Payment Errors: 'Capture Mode' and Extension Reinstallation Challenges

The OpenCart community forum recently highlighted a series of critical issues faced by a user attempting to integrate and manage the Mollie payment gateway. The discussion, initiated by mr_webshop_manager, revolved around a persistent 422 'Unprocessable Entity' error related to payment capture modes and subsequent difficulties with extension reinstallation after manual database intervention. This insight article provides a comprehensive breakdown of these challenges and offers actionable solutions for OpenCart store owners.

Understanding the Mollie 422 'Capture Mode' Error

The core of the initial problem was a Mollie API error stating:

Creating payment failed for order_id - 2 ; [2026-05-13T17:25:11+02:00] We could not process your request due to validation errors. Error executing API call (422: Unprocessable Entity): At least one of the provided payment methods must support captures.

This error, specifically the 422: Unprocessable Entity with the message "At least one of the provided payment methods must support captures," indicates that the payment method selected for the transaction (e.g., PayPal, iDEAL, Bancontact) does not support the capture mode specified in the payment request, or the Mollie account itself isn't configured for it. The user's confusion stemmed from the API response also showing "captureMode":"manual", making them wonder why it was asking to change to manual when it appeared to be manual already.

What 'Capture Mode' Means

In payment processing, 'capture mode' refers to how funds are captured after authorization. It can be:

• Automatic (or "Direct"): Funds are captured immediately after authorization.
• Manual (or "Delayed"): Funds are only authorized, and a separate action is required later to capture them.

The error message implies that the specific payment method chosen for the transaction requires a different capture mode than what was requested by the OpenCart Mollie extension. While the API response showed "captureMode":"manual", this might have been the requested mode that was rejected, not necessarily the mode the payment method supports or requires.

Actionable Solutions for Capture Mode Errors:

1. Check Mollie Dashboard Settings:
   • Log in to your Mollie dashboard.
   • Navigate to 'Settings' > 'Website profiles' > Select your profile > 'Payment methods'.
   • Review the settings for each payment method you intend to use. Some methods (e.g., iDEAL, Bancontact) are typically 'direct' capture only, while others (like credit card payments) might offer manual capture options. Ensure the 'Capture Mode' setting for the relevant payment method aligns with your OpenCart extension's configuration.
2. Verify OpenCart Mollie Extension Settings:
   • In your OpenCart admin panel, go to 'Extensions' > 'Extensions' > 'Payments'.
   • Find the Mollie Payment Gateway and click 'Edit'.
   • Look for a setting related to 'Capture Mode' or 'Payment API Method'. Ensure it's configured to either 'Automatic' or 'Manual' based on what your chosen Mollie payment methods support. If your Mollie account or specific payment method only supports automatic capture, ensure the extension is set accordingly.
3. Test with Different Payment Methods:

   If the error persists, try testing with a different payment method (e.g., a credit card if you were using iDEAL, or vice-versa) to isolate if the issue is specific to one method's capture capabilities.

Troubleshooting OpenCart Extension Reinstallation Issues

The second major hurdle encountered by mr_webshop_manager involved difficulties uninstalling and reinstalling the Mollie extension, leading to it not appearing in the payment methods list. This was exacerbated by manually deleting entries from the oc_extension_install database table.

Why Manual Database Deletion is Risky

Manually altering OpenCart's database tables like oc_extension_install, oc_extension, or oc_setting without a full understanding can lead to:

• Incomplete uninstalls, leaving orphaned files or database entries.
• Extensions not appearing in the admin panel.
• System instability or errors.

The message "complaining that it could not remove the extension since there was still an extension active" suggests that the extension's status in oc_extension or related settings tables was still marked as active, preventing a clean uninstall.

Proper OpenCart Extension Uninstall & Reinstall Procedure:

1. Deactivate the Extension: Always deactivate the extension from its respective list (e.g., 'Extensions' > 'Extensions' > 'Payments' for payment gateways) before attempting to uninstall.
2. Uninstall via Admin Panel: Go to 'Extensions' > 'Installer' > 'Uninstall' (if applicable) or directly from the extension list. This ensures OpenCart's internal mechanisms clean up database entries and files properly.
3. Clear Caches: After uninstalling, clear all OpenCart caches: 'Dashboard' > 'Developer Settings' > 'Clear Theme Cache' and 'Clear Sass Cache'. Also, clear your browser cache.
4. Manual Cleanup (If Stuck): If an extension still won't uninstall or reappears, you might need to check the following database tables (proceed with caution and always backup first!):
   • oc_extension: Look for entries related to 'mollie' and delete them.
   • oc_setting: Search for settings prefixed with 'mollie' and remove them.
   • oc_extension_install: (As mentioned by the user) This table tracks installed extensions. Ensure any 'mollie' related entries are removed.

   After manual cleanup, re-clear caches.

5. Reinstall the Latest Version: As suggested by JNeuhoff in the forum, downloading the latest version directly from the official GitHub repository (https://github.com/mollie/OpenCart) is often the best approach to ensure you have the most stable and compatible code. Use the OpenCart 'Installer' to upload the new zip file.
6. Activate and Configure: Once installed, go to 'Extensions' > 'Extensions' > 'Payments', find Mollie, install it (if needed), and then click 'Edit' to configure it with your Mollie API keys and settings.

Conclusion

Integrating payment gateways like Mollie into OpenCart requires careful configuration, both within the extension settings and the payment provider's dashboard. When issues arise, understanding the error messages and following proper extension management protocols are key. Manual database interventions should be a last resort and performed with extreme caution, ideally after a full backup and consultation with an expert. By systematically addressing capture mode settings and ensuring a clean extension installation, OpenCart users can overcome these common integration challenges.