Empower your WooCommerce store with seamless and secure online payments using the PayMongo WooCommerce plugin. This guide will walk you through understanding the plugin, its installation and configuration, supported payment methods, and how to manage refunds. Integrate PayMongo to provide your customers with diverse payment options, from cards and e-wallets to online banking, directly on your WordPress e-commerce platform.
Prerequisites for WooCommerce Integration
Before you begin the integration process, ensure you have:
An activated PayMongo merchant account with access to your Live Public and Secret API Keys.
An active WooCommerce store running on a WordPress website.
WooCommerce version 5.3.2 or higher.
PHP version 5.6 or higher.
Your WooCommerce store currency set to Philippine Peso (PHP), as the plugin only supports PHP transactions.
Note: The current widely available plugin is developed by CynderTech in collaboration with PayMongo.
Understanding the PayMongo WooCommerce Plugin
The PayMongo Payment Gateway for WooCommerce is a plugin that allows your online store to accept various payment methods directly.
No Coding Required: The plugin enables integration without needing to write any code.
Supported Payment Methods:
Cards: Visa, Mastercard (Credit and Debit Cards)
E-wallets: GCash, GrabPay, Maya, Atome, BillEase
Direct Online Banking: BPI, UnionBank
Test and Live Environments: The plugin supports both test and live environments, allowing you to thoroughly test payment workflows before accepting actual payments.
Minimum Transaction Amount: Transactions must be at least ₱100.00.
Step-by-Step Guide: Installing the PayMongo WooCommerce Plugin
For a comprehensive installation guide, please head on to our developer documentation at https://developers.paymongo.com/docs/woocommerce/.
Configuring Your PayMongo WooCommerce Plugin
After installation, you need to configure the plugin to connect your PayMongo account and enable desired payment methods.
Connecting Your PayMongo Account
In your WordPress dashboard, go to 'WooCommerce' > 'Settings'.
Click on the 'Payments' tab.
You will see various PayMongo payment options listed (e.g., "PayMongo - Cards," "PayMongo - GCash," etc.).
Choose a PayMongo payment option and click 'Set Up' or 'Manage'.
You will need to enter your Live Public API Key and Live Secret API Key from your PayMongo Dashboard to connect your account. These keys can be obtained by registering an account with PayMongo.
Toggle between Test and Live Mode: The plugin allows you to switch between test and live environments for thorough testing before going live.
Configuring Payment Methods (Cards, E-wallets, Online Banking)
Within the plugin's settings for each PayMongo payment option, you can configure which specific payment methods are active:
Cards: Enable credit/debit card payments (Visa and Mastercard).
E-wallets: Enable GCash, GrabPay, Maya, Atome, BillEase.
Direct Online Banking: Enable BPI and UnionBank.
Ensure that the payment methods you want to offer are enabled in both your PayMongo Dashboard settings and the WooCommerce plugin settings.
Webhook Configuration (Crucial)
For seamless processing of e-wallet payments, proper webhook configuration is essential.
The plugin generally requires you to generate a Webhook Secret Key. You can generate one at https://paymongo-webhook-tool.cynder.io/
You will then need to paste this generated Webhook Secret Key into the designated field within your WooCommerce PayMongo plugin settings.
This webhook enables PayMongo to send real-time notifications back to your WooCommerce store about payment statuses, ensuring your orders are updated correctly.
Managing Refunds for WooCommerce Transactions
You can refund WooCommerce transactions processed via PayMongo, but the process involves both your PayMongo Dashboard and your WooCommerce Dashboard.
Process Refund in PayMongo Dashboard:
Log in to your PayMongo Dashboard.
Go to either the "Links" or "Payments" section.
Select the specific payment that you wish to refund.
Click the "Refund" button and follow the prompts to complete the refund.
Manually Update Order Status in WooCommerce:
After processing the refund in your PayMongo Dashboard, you must manually update the order status of that transaction in your WooCommerce Dashboard to reflect the refund. This ensures your records are synchronized.
Troubleshooting Common WooCommerce Integration Issues
Plugin Compatibility: While the plugin is generally compatible, some WordPress themes or other plugins might cause conflicts. If you experience issues, try temporarily deactivating other plugins to isolate the conflict.
Transactions Not Going Through:
Verify that your PayMongo API keys (Public and Secret) are correctly entered in the plugin settings and that you are using Live keys for live transactions.
Ensure your PayMongo account is fully activated.
For e-wallet payments, double-check that your webhook secret is correctly configured.
Payment Method Not Appearing:
Confirm that the desired payment method is enabled both in your PayMongo Dashboard and in the WooCommerce plugin settings.
Clear any caching plugins you might be using on your WordPress site.