PayHere Gateway for Paymenter

[COLOR=rgb(0, 0, 0)]Accept Visa, MasterCard, Amex, Discover, mobile wallets, and local payment methods directly in Paymenter.
This production-ready gateway integrates PayHere with Paymenter, letting you collect secure payments in LKR and multiple currencies with real-time status updates via IPN webhooks.


Ideal for hosting providers, SaaS, and digital merchants who want a trusted Sri Lankan payment gateway with built-in fraud protection, recurring billing, and seamless checkout without building a custom payment stack.[/COLOR]

<span style="color:rgb(0, 0, 0)">&lt;b&gt;What this extension does&lt;/b&gt;</span>

• <b><span style="color:rgb(0, 0, 0)">Adds &amp;quot;PayHere&amp;quot; gateway</span></b><span style="color:rgb(0, 0, 0)"> in Paymenter (v1.0+)</span>
  
• <span style="color:rgb(0, 0, 0)">&lt;b&gt;Creates invoices&lt;/b&gt; with an extermal checkout (Pay Now)</span>
  
• <span style="color:rgb(0, 0, 0)">&lt;b&gt;Auto‑reconciles payments&lt;/b&gt; via IPN (PAID)</span>
  
• <span style="color:rgb(0, 0, 0)">&lt;b&gt;Attach Transactions &lt;/b&gt;to the Invoice</span>
  
• <span style="color:rgb(0, 0, 0)">&lt;b&gt;Supports Multiple Payment Methods &lt;/b&gt;(Visa/Master/FriMe etc)</span>
  
• <span style="color:rgb(0, 0, 0)">&lt;b&gt;Sandbox mode&lt;/b&gt; to test end‑to‑end without real funds</span>
  
• <span style="color:rgb(0, 0, 0)">&lt;b&gt;Clean logs&lt;/b&gt; and minimal configuration.</span>
  
• <span style="color:rgb(0, 0, 0)">&lt;b&gt;Multiple Currencies&lt;/b&gt; (USD/LKR)</span>
  

<span style="color:rgb(0, 0, 0)">Who is it for?</span>

• <span style="color:rgb(0, 0, 0)">Hosting/VPS providers and resellers using Paymenter</span>
  
• <span style="color:rgb(0, 0, 0)">SaaS and digital downloads needing global, borderless checkout</span>
  
• <span style="color:rgb(0, 0, 0)">Projects wanting to add Sri Lankan Based Gateway alongside existing gateways</span>
  

<span style="color:rgb(0, 0, 0)">How it works (flow)</span>

1. <span style="color:rgb(0, 0, 0)">Customer selects PayHere at checkout.</span>
   
2. <span style="color:rgb(0, 0, 0)">Extension redirects customer to the external hosted payment page</span>
   
3. <span style="color:rgb(0, 0, 0)">Customer pays in their chosen currency</span>
   
4. <span style="color:rgb(0, 0, 0)">Statuses are mapped in Paymenter (e.g., confirmed/finished → invoice marked paid).</span>
   

<span style="color:rgb(0, 0, 0)">Key Features</span>

• <b>S<span style="color:rgb(0, 0, 0)">ecure payment processing</span></b><span style="color:rgb(0, 0, 0)"> via NowPayments hosted checkout</span>
  
• <span style="color:rgb(0, 0, 0)">&lt;b&gt;Sandbox/Test mode&lt;/b&gt; for safe end‑to‑end testing</span>
  
• <span style="color:rgb(0, 0, 0)">&lt;b&gt;Works with Paymenter v1.3+&lt;/b&gt;</span>
  

<span style="color:rgb(0, 0, 0)">Requirements</span>

• <span style="color:rgb(0, 0, 0)">Paymenter v1.3 or newer</span>
  
• <span style="color:rgb(0, 0, 0)">A PayHere merchant account (sign up at <a href="&amp;#039;https://payhere.lk&amp;#039;" target="_blank" class="text-[var(--vp-c-brand-1)] hover:underline">payhere.lk</a>)</span>
  

<span style="color:rgb(0, 0, 0)">Installation</span>

[COLOR=rgb(0, 0, 0)]1) Install the Extension

Go to Admin → Browse Extensions in Paymenter and install Payhere.

2) Configure the Gateway

Navigate to Admin → Settings → Extension Settings and fill in:[/COLOR]

1. <b>Merchant ID</b> (from PayHere dashboard)
   
2. <b>Merchant Secret</b> (from PayHere dashboard)
   
3. <b>Allow </b>non-LKR/USD invoices
   
4. <b>Order/Invoice </b>Prefix
   
5. <b>Sandbox Mode</b> (optional)
   

Edit /var/www/paymenter/routes/web.php with your favourite text editor and place the below code at the bottom and Save .

[CODE=php]// Always load PayHere extension routes (return/cancel/ipn)
require base_path('extensions/Gateways/PayHere/routes.php');[/CODE]

<span style="color:rgb(0, 0, 0)">Testing (Sandbox)</span>

• [COLOR=rgb(0, 0, 0)]Enable <b>Sandbox Mode</b> in the gateway settings
  [LIST]
  
• Use the PayHere sandbox portal to generate test payments
  

[/COLOR]

Verify that Paymenter updates the invoice automatically
[/LIST]

<span style="color:rgb(0, 0, 0)">Troubleshooting</span>

<b>Payment not marked completed?</b>

• [COLOR=rgb(0, 0, 0)]Check Paymenter logs at:
  
  [CODE=bash]storage/logs/laravel.log[/CODE]
  [/COLOR]
  

Minimum amount errors?
Minimum amount will be depend on your payhere package.