{"id":7737,"date":"2025-10-31T09:49:44","date_gmt":"2025-10-31T13:49:44","guid":{"rendered":"https:\/\/geasypay.com\/complete-guide-installing-and-configuring-global-payments-on-woocommerce\/"},"modified":"2025-10-31T09:53:28","modified_gmt":"2025-10-31T13:53:28","slug":"complete-guide-installing-and-configuring-global-payments-on-woocommerce","status":"publish","type":"post","link":"https:\/\/geasypay.com\/en\/complete-guide-installing-and-configuring-global-payments-on-woocommerce\/","title":{"rendered":"Complete guide: installing and configuring Global Payments on WooCommerce"},"content":{"rendered":"<p class=\"whitespace-pre-wrap break-words\">Accepting online payments has never been easier! Thanks to <strong data-start=\"620\" data-end=\"639\">Global Payments<\/strong>, merchants of all sizes can collect secure payments directly from their <a href=\"https:\/\/geasypay.com\/en\/payment-solutions\/e-commerce\/\">WooCommerce<\/a> site. Whether you sell physical products, services or subscriptions, this step-by-step guide shows you how to install, configure and test your <strong data-start=\"921\" data-end=\"955\">Global Payments<\/strong> plugin <strong data-start=\"921\" data-end=\"955\">for Woocommerce<\/strong> with the support of <strong data-start=\"981\" data-end=\"993\">GeasyPay<\/strong>, official partner in Canada.  <\/p>\n<h2 data-start=\"1032\" data-end=\"1086\">Why choose Global Payments on WooCommerce?<\/h2>\n<p data-start=\"1088\" data-end=\"1373\">Global Payments is one of the world&#8217;s most reliable providers of payment solutions. It enables Canadian businesses to accept all major cards (Visa, Mastercard, American Express, Interac) as well as digital wallets such as Apple Pay or Google Pay. <\/p>\n<p data-start=\"1088\" data-end=\"1373\">Integrated with WooCommerce, the <strong data-start=\"1408\" data-end=\"1435\">Global Payments Gateway<\/strong> plugin transforms your WordPress site into a true <strong data-start=\"1484\" data-end=\"1516\">virtual payment terminal<\/strong>, compliant with PCI DSS standards and compatible with the <a href=\"https:\/\/geasypay.com\/en\/guide-to-integrating-an-online-sales-registration-module-system-mev-web\/\">MEV Web<\/a> in Quebec. In other words: a complete, fluid and secure payment system, directly linked to your store. <\/p>\n<h2 class=\"text-xl font-bold text-text-200 mt-1 -mb-0.5\">Prerequisites<\/h2>\n<p class=\"whitespace-pre-wrap break-words\">Before you start, make sure you have :<\/p>\n<ul>\n<li>A working WordPress site (version 5.6 or higher).<\/li>\n<li>Have an active SSL certificate and PHP 8.0<\/li>\n<li>WooCommerce plugin installed and activated (version 5.0 or higher).<\/li>\n<li>An active Global Payments merchant account in Canada<\/li>\n<li>Your API credentials: merchant ID, API key, shared secret, environment ID (for sandbox and production)<\/li>\n<\/ul>\n<h2>Step 1 &#8211; Installing the Global Payments plugin on WooCommerce<\/h2>\n<p class=\"whitespace-pre-wrap break-words\">There are two ways to install the Global Payments plugin:<\/p>\n<h3 class=\"text-lg font-bold text-text-200 mt-1 -mb-1.5\">Method A: Installation from the WordPress directory<\/h3>\n<ol class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-decimal space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">Log in to your WordPress dashboard<\/li>\n<li class=\"whitespace-normal break-words\">Navigate to <strong>Extensions &gt; Add<\/strong><\/li>\n<li class=\"whitespace-normal break-words\">In the search bar, type &#8220;Heartland&#8221;.<\/li>\n<li class=\"whitespace-normal break-words\">Click on <strong>Install<\/strong> on the Global Payments plugin on WooCommerce<\/li>\n<li class=\"whitespace-normal break-words\">Once installation is complete, click on <strong>Activate<\/strong><\/li>\n<\/ol>\n<h3>Method B: Manual installation<\/h3>\n<ol class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-decimal space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">Download the plugin ZIP file from <a href=\"https:\/\/wordpress.org\/plugins\/global-payments-woocommerce\/\" target=\"_blank\" rel=\"noopener\">the official website<\/a><\/li>\n<li class=\"whitespace-normal break-words\">Log in to your WordPress dashboard<\/li>\n<li class=\"whitespace-normal break-words\">Navigate to <strong>Extensions &gt; Add &gt; Upload an extension<\/strong><\/li>\n<li class=\"whitespace-normal break-words\">Click on <strong>Choose a file<\/strong> and select the downloaded ZIP file<\/li>\n<li class=\"whitespace-normal break-words\">Click on <strong>Install now<\/strong><\/li>\n<li class=\"whitespace-normal break-words\">Once installation is complete, click on <strong>Activate plugin<\/strong><\/li>\n<\/ol>\n<h2 class=\"text-xl font-bold text-text-200 mt-1 -mb-0.5\">Step 2: Basic configuration<\/h2>\n<p class=\"whitespace-pre-wrap break-words\">After activating the plugin, you need to configure the basic settings:<\/p>\n<ol class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-decimal space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">In the WordPress dashboard, go to <strong>WooCommerce &gt; Settings &gt; Payments<\/strong><\/li>\n<li class=\"whitespace-normal break-words\">You will see &#8220;Heartland&#8221; in the list of available payment methods.<\/li>\n<li class=\"whitespace-normal break-words\">Click on <strong>Finish configuration<\/strong><\/li>\n<\/ol>\n<h2 class=\"text-xl font-bold text-text-200 mt-1 -mb-0.5\">Step 3: Configuring API identifiers<\/h2>\n<p class=\"whitespace-pre-wrap break-words\">In the same configuration page :<\/p>\n<ol class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-decimal space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">Choose the environment :\n<ul class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-disc space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\"><strong>Sandbox<\/strong> for testing (strongly recommended before going into production)<\/li>\n<li class=\"whitespace-normal break-words\"><strong>Production<\/strong> for real transactions<\/li>\n<\/ul>\n<\/li>\n<li class=\"whitespace-normal break-words\">Enter your Global Payments API credentials :\n<ul class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-disc space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\"><strong>Merchant ID<\/strong>: your unique identifier provided by Global Payments<\/li>\n<li class=\"whitespace-normal break-words\"><strong>API key<\/strong>: your authentication key for the API<\/li>\n<li class=\"whitespace-normal break-words\"><strong>Shared key<\/strong>: used to secure communications<\/li>\n<li class=\"whitespace-normal break-words\"><strong>Environment ID<\/strong>: identifier specific to the selected environment<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h2 class=\"text-xl font-bold text-text-200 mt-1 -mb-0.5\">Step 4: Setting up payment options<\/h2>\n<p class=\"whitespace-pre-wrap break-words\">Configure the following options according to your needs:<\/p>\n<ol class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-decimal space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\"><strong>Accepted card types<\/strong>: select the cards you wish to accept (Visa, Mastercard, Amex, etc.).<\/li>\n<li class=\"whitespace-normal break-words\"><strong>Capture mode<\/strong>:\n<ul class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-disc space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\"><strong>Authorization and capture<\/strong>: the amount is debited immediately<\/li>\n<li class=\"whitespace-normal break-words\"><strong>Authorization only<\/strong>: the amount is reserved but will be captured manually later.<\/li>\n<\/ul>\n<\/li>\n<li class=\"whitespace-normal break-words\"><strong>Recurring payments<\/strong>: activate if you offer subscriptions<\/li>\n<li class=\"whitespace-normal break-words\"><strong>3D Secure<\/strong>: configuration for additional authentication (strongly recommended)<\/li>\n<li class=\"whitespace-normal break-words\"><strong>Payment page<\/strong>:\n<ul class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-disc space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\"><strong>Integrated<\/strong>: payment is made directly on your site<\/li>\n<li class=\"whitespace-normal break-words\"><strong>Redirection<\/strong>: the user is redirected to a Global Payments payment page<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h2 class=\"text-xl font-bold text-text-200 mt-1 -mb-0.5\">Step 6: Testing and validation<\/h2>\n<p class=\"whitespace-pre-wrap break-words\">Before going into production, test your :<\/p>\n<ol class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-decimal space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">Switch to <strong>Sandbox<\/strong> mode in Settings<\/li>\n<li class=\"whitespace-normal break-words\">Use the <a class=\"underline\" href=\"https:\/\/developer.globalpay.com\/resources\/test-card-numbers\" target=\"_blank\" rel=\"noopener\">test cards supplied by Global Payments<\/a>:\n<ul class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-disc space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">Test visa: 4242 4242 4242 4242<\/li>\n<li class=\"whitespace-normal break-words\">Test Mastercard: 5555 5555 5555 4444<\/li>\n<li class=\"whitespace-normal break-words\">Future expiration date (e.g. 12\/26)<\/li>\n<li class=\"whitespace-normal break-words\">CVV: 123<\/li>\n<\/ul>\n<\/li>\n<li class=\"whitespace-normal break-words\">Run several test commands to check :\n<ul class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-disc space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">Successful transactions<\/li>\n<li class=\"whitespace-normal break-words\">Refused transactions<\/li>\n<li class=\"whitespace-normal break-words\">Refunds<\/li>\n<li class=\"whitespace-normal break-words\">Manual captures (if configured in &#8220;Authorization only&#8221; mode)<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h2 class=\"text-xl font-bold text-text-200 mt-1 -mb-0.5\">Step 7: Global Payments go live on WooCommerce<\/h2>\n<p class=\"whitespace-pre-wrap break-words\">Once the tests have been passed :<\/p>\n<ol class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-decimal space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">Go back to the plugin settings<\/li>\n<li class=\"whitespace-normal break-words\">Switch environment from <strong>Sandbox<\/strong> to <strong>Production<\/strong><\/li>\n<li class=\"whitespace-normal break-words\">Update your API credentials with production ones<\/li>\n<li class=\"whitespace-normal break-words\">Save changes<\/li>\n<li class=\"whitespace-normal break-words\">Make a real test order with a small amount to confirm that everything works.<\/li>\n<\/ol>\n<h2 class=\"text-xl font-bold text-text-200 mt-1 -mb-0.5\">Common troubleshooting about Global Payments installation on WooCommerce<\/h2>\n<h3 class=\"text-lg font-bold text-text-200 mt-1 -mb-1.5\">Transactions systematically fail<\/h3>\n<ul class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-disc space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">Check that your API credentials are correct<\/li>\n<li class=\"whitespace-normal break-words\">Make sure the merchant account is active<\/li>\n<li class=\"whitespace-normal break-words\">Check for geographic or currency restrictions<\/li>\n<\/ul>\n<h3 class=\"text-lg font-bold text-text-200 mt-1 -mb-1.5\">Blank page at checkout<\/h3>\n<ul class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-disc space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">Check for conflicts with other plugins<\/li>\n<li class=\"whitespace-normal break-words\">Increase the PHP memory limit in your wp-config.php file<\/li>\n<li class=\"whitespace-normal break-words\">Activate logging and check for errors<\/li>\n<\/ul>\n<h3 class=\"text-lg font-bold text-text-200 mt-1 -mb-1.5\">3D Secure does not work<\/h3>\n<ul class=\"[&amp;:not(:last-child)_ul]:pb-1 [&amp;:not(:last-child)_ol]:pb-1 list-disc space-y-1.5 pl-7\">\n<li class=\"whitespace-normal break-words\">Check that your merchant account is set up for 3D Secure<\/li>\n<li class=\"whitespace-normal break-words\">Test with 3D Secure cards supplied by Global Payments<\/li>\n<li class=\"whitespace-normal break-words\">Check that your SSL is correctly configured<\/li>\n<\/ul>\n<h2>What you need to know about Global Payments on WooCommerce<\/h2>\n<ul>\n<li data-start=\"573\" data-end=\"790\">\n<p data-start=\"575\" data-end=\"790\">The plugin supports tokenization of saved cards for subscriptions (save cards \/ WooCommerce Subscriptions) if the function is enabled on the merchant account.<\/p>\n<\/li>\n<li data-start=\"791\" data-end=\"1004\">\n<p data-start=\"793\" data-end=\"1004\">It offers the possibility of making partial captures or refunds directly from the WooCommerce interface without going through the Global Payments back-office.<\/p>\n<\/li>\n<li data-start=\"1005\" data-end=\"1276\">\n<p data-start=\"1007\" data-end=\"1276\">During installation, it may be necessary to explicitly add your domain (and sub-domain) to the &#8220;list of secure domains&#8221; in the Global Payments back-office for notifications to work correctly.<\/p>\n<\/li>\n<li data-start=\"1277\" data-end=\"1527\">\n<p data-start=\"1279\" data-end=\"1527\">The plugin integrates with a wide range of payment methods (cards, digital wallets, multiple currencies) and provides advanced fraud management tools (3-D Secure, AVS, detection rules).<\/p>\n<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<p class=\"whitespace-pre-wrap break-words\">You have now successfully installed and configured the <strong>Global Payments<\/strong> plugin <strong>on WooCommerce<\/strong>. Don&#8217;t forget to update the plugin regularly to benefit from the latest features and security patches. For technical assistance, please <a href=\"https:\/\/geasypay.com\/en\/contact-geasy-pay\/\">contact Geasy Pay support<\/a>.  <\/p>\n","protected":false},"excerpt":{"rendered":"<p>Accepting online payments has never been easier! Thanks to Global Payments, merchants of all sizes can collect secure payments directly from their WooCommerce site. Whether you sell physical products, services or subscriptions, this step-by-step guide shows you how to install, configure and test your Global Payments plugin for Woocommerce with the support of GeasyPay, official [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":7738,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[60],"tags":[],"class_list":["post-7737","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-board"],"_links":{"self":[{"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/posts\/7737","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/comments?post=7737"}],"version-history":[{"count":2,"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/posts\/7737\/revisions"}],"predecessor-version":[{"id":7743,"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/posts\/7737\/revisions\/7743"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/media\/7738"}],"wp:attachment":[{"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/media?parent=7737"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/categories?post=7737"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/geasypay.com\/en\/wp-json\/wp\/v2\/tags?post=7737"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}