Skip to main content

Installing and Configuring the PayMongo Shopify Plugin

Updated yesterday

Integrating PayMongo with your Shopify store allows you to seamlessly accept various online payments without needing to code. This article provides a comprehensive guide to understanding the different PayMongo Shopify plugin options, their installation process, and how to configure key features like managing payment methods and enabling "Hold then Capture." Empower your Shopify store with PayMongo's secure and flexible payment solutions.


Prerequisites for Installation

Before you begin installing the PayMongo Shopify plugin, ensure you have:

  • An activated PayMongo merchant account with access to your Live Public and Secret API Keys.

  • An active Shopify store with administrative access.

  • Basic understanding of your Shopify store's settings, especially the "Payments" or "Payment providers" section.


Understanding PayMongo Shopify Plugin Options

PayMongo offers different Shopify plugin options to cater to various payment experiences and feature requirements. It's crucial to understand their functionalities and compatibilities:

1. "Express Cards via PayMongo":

  • Supports: Card payments.

  • Customer Experience: Allows customers to stay on your site during checkout.

  • Features: Does NOT support the "Hold then Capture" feature.

  • Compatibility: Can be used simultaneously with "Secure Payments via PayMongo."

2. "Credit/Debit Card via PayMongo":

  • Supports: Card payments.

  • Customer Experience: Redirects customers to a PayMongo-hosted checkout page.

  • Features: Includes the "Hold then Capture" feature.

  • Compatibility: CANNOT be used simultaneously with "Express Cards via PayMongo."

3. "Secure Payments via PayMongo":

  • Supports: A wider range of payment options, including cards, e-wallet (GCash, GrabPay, Maya), buy now pay later, and online banking (BPI, UnionBank, Brankas options).

  • Customer Experience: Redirects customers to a PayMongo-hosted checkout page.

  • Compatibility: Can be used simultaneously with "Express Cards via PayMongo."


Step-by-Step Guide: Installing Your PayMongo Shopify Plugin

For a comprehensive guide on installing any of the Shopify plugin options, please head on to our Developer Documentation at https://developers.paymongo.com/docs/shopify-1/


Managing Payment Methods on Checkout

If you are using the "Secure Payments via PayMongo" plugin, you can control which payment methods appear on your checkout page:

  1. Go to your Shopify Settings.

  2. Navigate to the "Payment providers" section.

  3. Search for "Secure Payments via PayMongo" and click on the "Manage" button.

  4. You will be redirected to a screen where you can select or deselect the specific payment methods you want to accept (e.g., specific e-wallets, online banking options). You can also change the PayMongo account associated with your store here.

  5. After making your selections, click on the "Save payment method" button to finalize your changes.

  6. Important: If you enable or disable certain payment methods, ensure you also check or uncheck the corresponding payment method icons on Shopify's separate checklist. This impacts which payment method logos appear to the customer on the Shopify checkout page.


Setting Up "Hold then Capture"

The "Hold then Capture" feature (available with the "Credit/Debit Card via PayMongo" plugin) allows you to authorize a customer's card for a payment amount, but only capture the funds later. This is useful for pre-orders or services where the final amount isn't known until fulfillment.

  • To enable this, you must install the "Credit/Debit Card via PayMongo" plugin and set your Shopify payment capture to "Manually capture payment for orders" as described in Section 3.3.3.

  • Once configured, you will be able to manually capture the payment from the Shopify order details page when you are ready to fulfill the order.


Troubleshooting Common Shopify Plugin Issues

  1. "Your payment cannot be processed for technical reasons."

    • This error often indicates an issue with your PayMongo API keys or plugin configuration. Double-check that you've entered the correct Live Public and Secret API keys in your Shopify settings.

    • Ensure your PayMongo account is fully activated and in Live Mode.

  2. "My customer's transactions are failing after installing Express Cards via PayMongo."

    • Verify that your Shopify payment capture setting is correctly set to "Automatically at Checkout" for Express Cards via PayMongo.

    • Check for plugin conflicts; ensure you are not using "Express Cards via PayMongo" simultaneously with "Credit/Debit Card via PayMongo."

  3. "Why is my payment getting flagged as risky by Shopify?"

    • Shopify has its own fraud analysis. While PayMongo handles payment processing securely, Shopify might flag transactions based on its internal rules. Review Shopify's fraud analysis section for more details.

  4. "Why can't I refund Shopify transactions from the PayMongo Dashboard?"

    • As a design feature, all Shopify transactions can only be refunded directly through the Shopify admin panel. Refunds initiated on Shopify automatically reflect on your PayMongo Dashboard. This is to ensure synchronization between both platforms.

  5. "My promotion is not reflecting on Shopify."

    • This might be related to Shopify's discount settings or how promotions interact with payment gateways. Check your Shopify discount configurations.

Did this answer your question?