A secure payment gateway plugin for WooCommerce using GetPay.

citytechglobal

<p>A secure payment gateway plugin for WooCommerce using GetPay.</p>
<p>GetPay WooCommerce Integration</p>
<p>A secure payment gateway plugin that integrates the <strong>GetPay</strong> payment system with <strong>WooCommerce</strong> for WordPress e-commerce stores.</p>
<p></p>
<h3>Table of Contents</h3>
<ul>
<li><a href="#prerequisites" rel="nofollow ugc">Prerequisites</a></li>
<li><a href="#installation" rel="nofollow ugc">Installation</a></li>
<li><a href="#configuration" rel="nofollow ugc">Configuration</a></li>
<li><a href="#page-setup" rel="nofollow ugc">Page Setup</a></li>
<li><a href="#testing" rel="nofollow ugc">Testing</a></li>
<li><a href="#troubleshooting" rel="nofollow ugc">Troubleshooting</a></li>
<li><a href="#support" rel="nofollow ugc">Support</a></li>
<li><a href="#security-notes" rel="nofollow ugc">Security Notes</a></li>
<li><a href="#changelog" rel="nofollow ugc">Changelog</a></li>
</ul>
<h3>Prerequisites</h3>
<p>Before installing the GetPay plugin, ensure you have:</p>
<ul>
<li>✅ WordPress site with admin access</li>
<li>✅ WooCommerce plugin installed and activated</li>
<li>✅ GetPay merchant account (credentials from your bank)</li>
<li>✅ SSL certificate installed (recommended for security)</li>
</ul>
<h3>Configuration</h3>
<h3>Step 1: Access Payment Settings</h3>
<ul>
<li>Navigate to <strong>WooCommerce > Settings > Payments</strong></li>
<li>Locate <strong>GetPay Gateway</strong> in the list</li>
<li>Click <strong>Manage</strong> or <strong>Set up</strong></li>
</ul>
<h3>Step 2: Configure Required Fields</h3>
<p>  Field<br />
  Description<br />
  Example</p>
<p>  <strong>Enable</strong><br />
  Check to activate GetPay<br />
  ☑️</p>
<p>  <strong>Title</strong><br />
  Customer-facing payment title<br />
  GetPay</p>
<p>  <strong>PAP Info</strong><br />
  Payment Application Provider info (from bank)<br />
  <code>eyJpbn...</code></p>
<p>  <strong>OPR Key</strong><br />
  Operational key<br />
  <code>4fa4c6b9-...</code></p>
<p>  <strong>INS Key</strong><br />
  Institution key (if any)<br />
  (blank)</p>
<p>  <strong>Website Domain</strong><br />
  Your site domain (with HTTPS)<br />
  <code>https://your-site.com</code></p>
<p>  <strong>Bundle JS URL</strong><br />
  GetPay JS bundle<br />
  <code>https://minio.finpos.global/.../bundle.min.js</code></p>
<p>  <strong>Success URL</strong><br />
  Redirect on successful payment<br />
  <code>https://your-site.com/success</code></p>
<p>  <strong>Fail URL</strong><br />
  Redirect on failed payment<br />
  <code>https://your-site.com/fail</code></p>
<p>  <strong>Base URL</strong><br />
  GetPay API base endpoint<br />
  <code>https://uat-bank-getpay.nchl.com.np/...</code></p>
<ul>
<li>Click <strong>Save Changes</strong></li>
</ul>
<h3>Page Setup</h3>
<h3>Step 1: Create Pages</h3>
<p>Create the following pages via <strong>Pages > Add New</strong>:</p>
<h4>🛒 Cart Page</h4>
<ul>
<li><strong>Title:</strong> Cart</li>
<li><strong>Content:</strong> <code>[woocommerce_cart]</code></li>
</ul>
<h4>💳 Checkout Page</h4>
<ul>
<li><strong>Title:</strong> Checkout</li>
<li><strong>Content:</strong> <code>[woocommerce_checkout]</code></li>
</ul>
<h4>💰 Payment Page</h4>
<ul>
<li><strong>Title:</strong> Payment</li>
<li><strong>Content:</strong> Add the following HTML tag to embed the payment interface: <code><div id="checkout"></div></code></li>
<li><strong>Purpose:</strong> This page serves as the payment processing screen where the GetPay JS bundle will render the secure payment interface.</li>
</ul>
<h4>✅ Success Page</h4>
<ul>
<li><strong>Title:</strong> Payment Success</li>
<li><strong>Content:</strong> Add the following shortcode in the content area of the page:<br />
  [getpay_check_success_page]</li>
<li><strong>URL:</strong> The page URL must exactly match the <strong>Success URL</strong> you have configured in the GetPay plugin settings (e.g., <code>https://your-site.com/success</code>).</li>
<li><strong>Custom Content:</strong> You may add additional messages, images, or layout elements <em>after</em> the shortcode if needed. However, <strong>do not remove or modify the shortcode</strong>, as it is essential for validating and displaying the payment confirmation.</li>
</ul>
<h4>❌ Failure Page</h4>
<ul>
<li><strong>Title:</strong> Payment Failed</li>
<li><strong>Content:</strong> You can display a custom message such as: <code>[getpay_check_fail_page]</code></li>
<li><strong>URL:</strong> The page URL must exactly match the <strong>Fail URL</strong> you have configured in the GetPay plugin settings (e.g., <code>https://your-site.com/fail</code>).</li>
<li><strong>Custom Content:</strong> You may customize the message or design of this page to fit your site’s branding, but make sure the URL is correct to ensure users are properly redirected after a failed transaction.</li>
</ul>
<h3>Step 2: Assign Pages in WooCommerce</h3>
<ul>
<li>Go to <strong>WooCommerce > Settings > Advanced</strong></li>
<li>Set:
<ul>
<li><strong>Cart page:</strong> Cart</li>
<li><strong>Checkout page:</strong> Checkout</li>
</ul>
</li>
<li>Click <strong>Save Changes</strong></li>
</ul>
<h3>Testing</h3>
<h3>Test Mode</h3>
<ul>
<li>Use <strong>sandbox credentials</strong> from your bank</li>
<li>Test with provided test card numbers</li>
<li>Verify flows: ✅ success, ❌ failure, ✋ cancellation</li>
</ul>
<h3>Live Mode</h3>
<ul>
<li>Replace test keys with <strong>production credentials</strong></li>
<li>Update <strong>Base URL</strong> to production endpoint</li>
<li>Run small-amount test transactions before going live</li>
</ul>
<h3>Troubleshooting</h3>
<h3>Plugin Not Appearing</h3>
<ul>
<li>Ensure <strong>WooCommerce is activated</strong></li>
<li>Check if <strong>GetPay plugin is active</strong></li>
<li>Verify <strong>GetPay Gateway is enabled</strong> under payment methods</li>
</ul>
<h3>Payment Failures</h3>
<ul>
<li>Double-check <strong>PAP/OPR/INS credentials</strong></li>
<li>Ensure <strong>site has valid SSL</strong></li>
<li>Check if <strong>JS bundle and API endpoints are accessible</strong></li>
</ul>
<h3>Redirect Issues</h3>
<ul>
<li>Make sure success/fail URLs are correct</li>
<li>Pages should be <strong>published</strong> and match settings</li>
</ul>
<h3>Debug Logs</h3>
<ul>
<li>Go to <strong>WooCommerce > Status > Logs</strong></li>
<li>Check logs prefixed with <strong>getpay</strong></li>
<li>Look for API errors or response messages</li>
</ul>
<h3>Support</h3>
<h3>🛠️ Plugin Issues</h3>
<ul>
<li>Contact your plugin development team</li>
</ul>
<h3>🏦 Payment Issues</h3>
<ul>
<li>Contact your bank’s <strong>GetPay support team</strong></li>
</ul>
<h3>📖 WooCommerce</h3>
<ul>
<li>Refer to <a href="https://woocommerce.com/documentation/" rel="nofollow ugc">WooCommerce documentation</a></li>
</ul>
<h3>Security Notes</h3>
<ul>
<li>🔒 Always use HTTPS in production</li>
<li>🔁 Keep plugin updated</li>
<li>💾 Regularly back up your site</li>
<li>🔐 Never share your credentials publicly</li>
<li>🧪 Fully test before enabling live payments</li>
</ul>

Alternatives to GetPay Payment Integration

Top alternatives