All docs
Payments
Updated 2026-04-28
4 min read
PayHere setup
Configure PayHere with your merchant ID and secret key for LKR card payments.
PayHere is the most popular payment gateway in Sri Lanka. It accepts Visa, Mastercard, AMEX, and local bank cards. Setup takes about 10 minutes.
What you'll need
- A registered PayHere merchant account.
- Your business registration documents (PayHere will ask for verification).
- The domain your storefront runs on (for example, your-store.gannako.com or your custom domain).
Step 1 — Sign up with PayHere
- Go to payhere.lk and create a merchant account.
- Wait for PayHere to approve your account. They review your business and bank details — this usually takes 1-3 working days.
Step 2 — Register your domain
PayHere only accepts payments from domains it recognizes. You must register your domain before any payment will work.
- Sign in to your PayHere dashboard at payhere.lk/account.
- Click Settings → Domains & Credentials.
- Click Add Domain and enter
gannako.com. If you have already connected a custom domain to your store, use your custom domain instead (for exampleyourbrand.com). - Add a sandbox domain too if you want to test before going live.
Step 3 — Copy your credentials
- Still on the Domains & Credentials page, find your Merchant ID at the top — copy it.
- Below that, click Generate Merchant Secret (or reveal the existing one) and copy the secret.
Step 4 — Paste credentials into Gannako
- In Gannako admin, open Settings → Payments → PayHere.
- Click the API Credentials tab.
- Paste your Merchant ID and Merchant Secret.
- Click Save.
- On the main payments page, toggle PayHere Enabled.
Step 5 — Test, then go live
- Leave Test Mode on. Place a test order — PayHere shows a sandbox checkout where you can use any card.
- Confirm the order moves to Paid in your admin dashboard.
- Switch Test Mode off and run a real order (you can refund it after) to confirm live payments work.