Ecom Store Pro

How to Connect PayHere to Shopify: Setup, Sandbox and Fixes

Connect PayHere to a Shopify store in Sri Lanka: account approval, the free app, Merchant ID and Secret, sandbox testing, fees, and fixes when it's missing.

Listen to a short brief of this article
Hands-free while you multitask

The short version

Connect PayHere by installing its free PayHere Payment Gateway app from the Shopify App Store, entering the Merchant ID and Merchant Secret from the Integrations section of your PayHere account, and clicking Save and then Activate PayHere Payment Gateway.

First you need an approved PayHere account, which a partner bank reviews in 1 to 3 days according to PayHere's application page archived in October 2025, and a store address in Sri Lanka, because Shopify filters the third-party provider list in your admin by that address.

Each sale then pays PayHere's fee, 3.3% on its LITE plan for an LKR Visa or Mastercard payment in PayHere's July 2025 fee list, plus Shopify's third-party fee of 2% on Basic down to 0.2% on Plus.

Shopify Payments isn't available to a store in Sri Lanka: as of November 2026 the country isn't on Shopify's list of Shopify Payments countries, so a Sri Lankan store takes cards and local wallets through a third-party provider. PayHere is one of them, and it connects through its own free app, PayHere Payment Gateway, which the listing says collects the payments to your business bank account at any Sri Lankan bank.

Where you start depends on where you are. If you haven't applied to PayHere yet, start with the two gates, because one of them can rule your business out. If you've installed the app and can't find PayHere in Settings > Payments, go straight to what to check.

Before You Connect PayHere: Two Gates

Key takeaway

The first gate decides whether PayHere will process and pay out your money at all. The second decides whether PayHere appears in your Shopify admin. Neither can be fixed from the other side, so clear both before you install anything.

Gate One: An Approved PayHere Account

Key takeaway

PayHere's application process page, archived on October 7, 2025, opens the door to any business in Sri Lanka that sells goods or services to local or foreign customers and accepts payments remotely. Whether you also need a business registration depends on the type of business:

Who needs a business registration for PayHere
Type of businessBusiness registration needed?
Private Limited CompanyYes
Sole ProprietorshipYes
PartnershipYes
Home-based businessNo, but a valid proof of business is required
Freelance businessNo, but a valid proof of business is required
Clubs and associationsNo, but a valid proof of business is required
Government organizationNo, but a valid proof of business is required

PayHere's application process page, last updated January 31, 2025, as archived on October 7, 2025.

Payouts go to a bank account in Sri Lanka, and PayHere asks you to upload a valid proof of that account so it can verify the account number. A home-based or freelance business can use a personal bank account at any local bank; companies, partnerships and sole proprietorships use a business account.

PayHere also reviews your website before approval. Its page says websites under construction, with mock products or incomplete content, are rejected, and it lists pages the site must already carry:

  • A terms page
  • A return policy
  • A privacy policy
  • Contact details

Approval isn't PayHere's decision alone. One of its partner banks reviews each business under Central Bank regulations, which takes 1 to 3 days, and PayHere says it has no control over the approval or the rejection. Applying costs nothing: PayHere charges no application or setup fee.

Business models PayHere won't accept

PayHere's list of categories and models it can't serve, because of payment regulations and partner bank policies, includes three that are common on Shopify: drop-shipping, print-on-demand and multi-vendor platforms. If a partner bank rejects a business for its nature, PayHere says you won't be able to reapply, so read the list on the application page before you submit.

If you'd rather watch the sign-up, the LK Web Design Academy (WPSinhala) channel published a 33-minute walkthrough in Sinhala on January 1, 2025. Its chapters cover what you need to register (from 00:00), the registration itself (05:40) and creating a Sandbox test account (22:32); the last chapter, from 24:25, connects PayHere to WooCommerce rather than Shopify, so you can stop there. It's one creator's tutorial, and the requirements on this page come from PayHere's own pages.

PayHere Payment Gateway - Sinhala TutorialA Sinhala walkthrough from the LK Web Design Academy (WPSinhala) channel, January 2025: what PayHere asks for, how to register, and how to create a Sandbox test account; its final chapter covers WooCommerce, not Shopify.

Gate Two: A Store Address in Sri Lanka

Key takeaway

The second gate sits in your Shopify admin. Shopify says the list of providers you see depends on one setting:

The third-party provider list in your Shopify admin is filtered based on your store's address in Settings > General.
Shopify Help Center — Configuring third-party payment providers ·

So open Settings > General and check the store address before you install the app. If a provider you expect isn't listed, Shopify's advice is to verify that your store address matches the country or region where the provider operates; for PayHere that is Sri Lanka. One more condition applies if PayHere sits under Payment providers: Shopify says only the store owner can add a credit card payment provider.

In Shopify adminOpen in your store
  1. Settings
  2. General
Check the Store address row; in the store shown, outside Sri Lanka, it reads Ukraine, as of November 10, 2026.

Currency is the other thing to settle early. PayHere's general questions page names five currencies it accepts, LKR, USD, GBP, EUR and AUD, but its fee list, archived July 16, 2025, limits the LITE plan to LKR and USD. Shopify's help pages on configuring providers, gateway availability and additional payment methods, as we read them in November 2026, don't tie your store currency to the provider list, so the limit to plan around is PayHere's.

How to Connect PayHere to Shopify, Step by Step

Key takeaway

These steps follow PayHere's Shopify instructions as archived on July 16, 2025, with the listing details the Shopify App Store showed on November 14, 2026. PayHere's page was last updated on July 19, 2022, so screen labels may have moved since. Step 2 happens in your PayHere account, the rest in Shopify.

Connect PayHere to Shopify, step by stepTick each step as you finish it. Clear both gates above first: an approved PayHere account and a store address in Sri Lanka.

Connect PayHere to Shopify, step by step

Tick each step as you finish it. Clear both gates above first: an approved PayHere account and a store address in Sri Lanka.

0 of 5 done
  1. Open the PayHere Payment Gateway listing on the Shopify App Store, click Install, then click Install app on the installation page in your Shopify admin.

  2. In your PayHere account, open the Integrations section and copy the Merchant ID and the Merchant Secret.

  3. Paste both values into PayHere's settings page in Shopify; tick Sandbox Mode only if they come from a PayHere Sandbox account, and untick it for live payments.

  4. Click Save, then scroll down and click Activate PayHere Payment Gateway.

  5. Go to Settings > Payments, find PayHere Payment Gateway and click Manage to check its account status.

For step 1, open the listing and check that it reads PayHere Payment Gateway with PayHere as the developer before you click Install. The listing shows the app as free:

Shopify App Store listing for PayHere Payment Gateway
Step 1: the PayHere Payment Gateway listing, with Install on the left, as of November 14, 2026.

On the app installation page in your admin, click Install app. PayHere's instructions then continue on the app's settings page, where the credentials go; the listing describes the whole setup as installing the app and configuring it with your PayHere Merchant credentials.

If PayHere asks you to add a domain

PayHere's Checkout API page, last updated March 9, 2023, says the Merchant ID is unique to your PayHere account but the Merchant Secret is specific to the integrating domain or app, and that approval of a new domain or app takes up to 24 hours. PayHere's Shopify instructions ask only for the Merchant ID and Merchant Secret, so if the Integrations section asks you to add a domain first, allow for that approval before you enter the Secret.

Where PayHere Shows Up in Settings > Payments

Key takeaway

After activation, PayHere's instructions send you to Settings > Payments to find PayHere Payment Gateway under "Supported payment methods" (or "Additional payment methods") and click Manage, which is also where you change its settings later.

Those section names date from 2022. Shopify's Help Center today describes additional payment providers installed as apps from the Payments section, which you configure and then activate before you can use them, and its guide to configuring providers says some providers, including regional payment methods, are also configured in the Additional payment methods section rather than through the third-party provider selector.

What Shopify doesn't settle is PayHere itself: no Shopify page we read in November 2026, across its Help Center pages on payment providers, additional payment methods and test orders and its developer docs on payments apps, names PayHere or says which section of Settings > Payments it appears in. If you find it under Payment providers instead, one rule applies there: you can have only one credit card payment provider activated at a time.

PayHere Isn't in Settings > Payments: What to Check

Key takeaway

You installed the app, but PayHere doesn't show at checkout. Or you search for PayHere among the providers and get no result. Or PayHere appears at checkout, but no money reaches your account. Each has its own cause:

Symptoms, causes and fixes
What you seeLikely causeWhat to do
PayHere isn't among the providers in Settings > PaymentsShopify filters the third-party provider list by your store address in Settings > GeneralCheck that the store address is in Sri Lanka, where PayHere operates
You installed the app, but PayHere doesn't show at checkoutShopify shows an additional payment method at checkout only after you configure and activate its appOpen the app, click Save, then Activate PayHere Payment Gateway
An old PayHere plugin still sits in Settings > PaymentsA PayHere plugin from before the current appRemove the old plugin in Settings > Payments, as PayHere's instructions say
You can't add a payment provider at allFor a credit card payment provider, Shopify says only the store owner can add oneSign in as the store owner
PayHere shows at checkout, but no real money reaches your accountSandbox Mode is still ticked, or the credentials come from a Sandbox accountEnter the live Merchant ID and Secret, untick Sandbox Mode and click Save
The address is in Sri Lanka and the app is installed, but PayHere still isn't availableA listing doesn't guarantee access in every store's adminContact PayHere's support, which the listing names for this app

One more reason sits outside your settings. When we filtered Shopify's payment gateways page by Sri Lanka on November 14, 2026, PayHere wasn't among the providers it listed, although its App Store listing was live the same day. That doesn't decide whether PayHere works in your store; see which providers Shopify lists for Sri Lanka and how to read the difference. Shopify's help says a gateway missing from its region's list might not be supported by Shopify at this time, and that a listing doesn't guarantee access either:

A provider's listing in the payment gateways page doesn't guarantee it's accessible in your specific store's admin due to factors such as your store's location, plan, or payment configuration.
Shopify Help Center — Configuring third-party payment providers ·

Shopify also documents a stage at which a payments app isn't discoverable in the Shopify admin but can be installed through a shared installation URL. If you suspect that is your case, PayHere's support is the one to ask.

For anything the table doesn't solve, the listing names the right contact: app support is provided by PayHere. Shopify draws the same line, sending questions about a provider's integration and features to the provider and questions about setting up a provider to Shopify Support. You can also reach a provider from the Payments section of your Shopify settings.

Test PayHere With a Sandbox Account First

Key takeaway

PayHere's Sandbox is a test environment for its merchant portal and your integration, and none of the payments in it are actually processed. It's a completely separate deployment: you can't convert a Sandbox account into a live one, or use anything you entered in Sandbox for your live account.

To move from Sandbox to live once PayHere approves your account:

  1. Copy the Merchant ID and Merchant Secret from Integrations in your live PayHere account.
  2. In Shopify, go to Settings > Payments, find PayHere Payment Gateway and click Manage.
  3. Replace the Sandbox values, untick Sandbox Mode and click Save.

Don't leave the last step for later. Shopify has a general warning for payment providers left in test mode:

Customers can't place live orders during the time that your payment providers are in test mode.
Shopify Help Center — Testing your checkout with test orders ·

Shopify adds that you can test a payment gateway only after you've chosen a paid plan. If you'd rather check the checkout flow without PayHere at all, Shopify's Test payment gateway works on any store, but only after you deactivate any active credit card provider; here's how to place an order with the Test payment gateway.

What PayHere on Shopify Costs per Sale

Key takeaway

The app is free, so the cost arrives on two bills. PayHere takes its processing fee on each payment, and Shopify's third-party transaction fee comes in addition to the processing fees your provider charges.

PayHere's Plans and What They Cost

Key takeaway
PayHere's main plans, as archived July 16, 2025
PayHere planProcessing feeMonthly feeWhat PayHere's page adds
LITE3.3%NoneOne-time payments in LKR and USD only, up to Rs.50,000 per payment and Rs.200,000 a month
PLUS2.99%Rs.3,990Payments in LKR, USD, EUR, GBP and AUD, up to Rs.250,000 per payment and Rs.3,000,000 a month
PREMIUM2.69%Rs.9,990Lowest processing fee; payments in LKR, USD, EUR, GBP and AUD, up to Rs.1,000,000 per payment, no monthly payment limit

PayHere's limits and fees page, last updated January 31, 2025, as archived on July 16, 2025; PayHere's own figures, not Shopify's. The live page wasn't reachable to our tools in November 2026, so confirm current rates with PayHere.

The cap, not the rate, is what moves most stores up. At LITE's full Rs.200,000 a month in LKR Visa or Mastercard payments, its 3.3% comes to Rs.6,600, while PLUS at 2.99% plus its monthly fee comes to Rs.9,970, both by PayHere's fee list archived on July 16, 2025. PREMIUM's higher monthly fee pays for itself against PLUS only above Rs.2,000,000 in monthly sales.

PayHere's fees page (archived July 16, 2025) adds 0.5% on top of your plan's rate for American Express, Discover and Diners Club cards, and 1.0% for payments in a foreign currency, which it converts and settles in LKR.

Shopify's Third-Party Fee on Top

Key takeaway

Shopify charges 2% on Basic, 1% on Grow, 0.6% on Advanced and 0.2% on Plus when a store uses a provider other than Shopify Payments. The fee applies whichever section of Settings > Payments PayHere sits in, because Shopify charges it on purchases paid with an additional payment method too. For when the fee is waived and how it compares across gateways, see how Shopify's third-party surcharge works by plan.

Here is one order worked through, for a local LKR card payment on Visa or Mastercard. A customer pays Rs.10,000 with PayHere on the LITE plan, so at the 3.3% in PayHere's fee list archived July 16, 2025, PayHere keeps Rs.330. Shopify's fee on the Basic plan adds Rs.200. The sale costs Rs.530 in fees, and every other plan combination is the same two lines with different rates, plus PayHere's 0.5% or 1.0% surcharge where one applies.

Refunds change the Shopify side. In a country where Shopify Payments isn't available, Shopify refunds its transaction fees in proportion to the amount refunded only when the refund goes through the Shopify admin; the refunds section covers what that means for PayHere orders.

When PayHere Pays You

PayHere settles online payments to your bank account daily, on a T+2 cycle: two days after it receives the payment notification. Getting paid in US dollars takes a separate, new PayHere account with USD as its payout currency and a USD account at Seylan Bank; PayHere's USD payouts page (archived October 7, 2025) lists 3.99% on PLUS and 3.69% on PREMIUM for those accounts. That page calls the Seylan account a BFC account and caps PLUS at USD 1,000 per payment and USD 10,000 a month, and PREMIUM at USD 5,000 per payment. PayHere offers USD payouts only to registered businesses on the PLUS or PREMIUM plan.

What Your Customers Can Pay With

Key takeaway

Two PayHere pages list the methods, and they don't match exactly. The App Store listing, as of November 14, 2026, and PayHere's general questions page, archived on October 7, 2025, agree on the cards and most wallets:

Payment methods by PayHere page
Payment methodOn the Shopify App Store listingIn PayHere's FAQRefund through PayHere
Visa, Mastercard, American Express, Discover, Diners ClubYes, as credit or debit cardsYes, as cardsYes: card payments are the ones PayHere can refund
HelaPayYes, as a Sri Lankan digital walletYes, as a bank account paymentNo, refund the customer manually
Frimi, Genie, iPay, Q PlusYes, as Sri Lankan digital walletsYes, as walletsNo, refund the customer manually
Sampath VishwaNot named in the listing textYes, as a walletNo, refund the customer manually

Listing read November 14, 2026; PayHere general questions page archived October 7, 2025; PayHere refund page archived July 16, 2025.

Since both lists are PayHere's own, ask PayHere which methods your account will show your customers before you promise one on your store. The refund column matters as much as the list: a wallet payment means a manual refund.

Refunds, Payment Order and Switching PayHere Off

Key takeaway

These questions come up after the first orders, and each is handled in a different place.

How Refunds Work for PayHere Orders

Key takeaway

PayHere's refund page, last updated June 11, 2024 and archived on July 16, 2025, sets these rules:

  • Where: in your PayHere account, under Payments, find the payment and click Request Refund.
  • Full refunds only: for a partial refund, you refund the customer manually.
  • Cards only: only card payment methods can be refunded technically through PayHere; wallet payments are refunded manually.
  • Timing: an instant refund on the day of the payment, or a delayed refund that PayHere says can take 5 to 10 days or even longer to reach your customer.
  • Cost: free of charge on every PayHere plan.
Where you refund decides whether Shopify's fee comes back

In a country without Shopify Payments, such as Sri Lanka, Shopify gives its third-party transaction fee back only when you refund an order through your Shopify admin; it says a refund made through a third-party payment gateway earns no transaction fee credit. PayHere's refund page, by contrast, describes refunds started from your PayHere account. Before your first return, ask PayHere's support whether a refund recorded in Shopify also goes through PayHere, so both the money and Shopify's fee credit come back.

Reordering Payment Methods: PayHere's Tip Is Out of Date

Key takeaway

PayHere's instructions answer the question of putting PayHere first with Shopify Scripts: on Shopify Plus, use Scripts to re-order the gateways, otherwise contact Shopify Support. That advice has expired. Shopify closed editing and publishing of Scripts on April 15, 2026, and all Scripts ceased to execute on June 30, 2026.

The successor is a payment customization built with Shopify Functions, which can hide, reorder and rename the payment options buyers see at checkout. Merchants get one through an App Store app rather than code, and Shopify notes that plan and geographical restrictions apply, so check an app's listing for Sri Lanka before you rely on it. For what replaced each kind of Script, see our guide to moving from Scripts to Functions.

How to Switch PayHere Off Without Losing Refunds

Key takeaway

Shopify's steps for an app under Additional payment methods, one of the two section names PayHere's instructions give:

  1. Go to Settings > Payments.
  2. Find PayHere Payment Gateway and click Manage.
  3. Click Deactivate, then Deactivate Payments App.
Deactivate, don't uninstall

Shopify's caution is direct: don't uninstall an additional payment method app, because an uninstalled app won't be available for use with any outstanding order returns. A deactivated one is removed from your list of available payment methods but stays available for cases such as order returns.

The Bottom Line

Key takeaway

The order matters more than any single setting: approval before the install, the Sri Lankan address before you look for PayHere, live credentials before the first real order. If PayHere still doesn't appear after that, the next step is PayHere's support, not another setting.

Get approved first, then install. The partner-bank review takes 1 to 3 days, by PayHere's application page archived in October 2025, and can't be repeated for a refused business model, while the connection itself is five steps once your address is right. Decide how you will handle refunds before the first order, because they start in PayHere.
Your Next Step by Stage
If buyers ask for PayPalSee whether a Shopify store in Sri Lanka can take PayPal as of November 2026, and what to use meanwhile.Read about PayPal in Sri Lanka
If checkout refuses paymentsFind out what the error saying a store can't accept payments means and where in Settings it gets fixed.Fix a store that can't accept payments
Once you take card paymentsCheck which parts of PCI compliance stay with you when a third-party gateway handles the card payment.Read the PCI compliance guide

Shopify's Fee on PayHere Sales Falls With Your Plan

Every PayHere sale also carries Shopify's third-party fee, as of November 2026: 2% on Basic, 1% on Grow, 0.6% on Advanced and 0.2% on Plus. Check the plans against your monthly PayHere volume.

Compare Shopify plans

Frequently Asked Questions

Yes, through PayHere's free PayHere Payment Gateway app on the Shopify App Store. Shopify Payments isn't available in Sri Lanka, so a Sri Lankan store needs a third-party provider. You need an approved PayHere account and a store address in Sri Lanka, because Shopify filters the third-party provider list in your admin by the store address in Settings > General.
The app itself is free on the Shopify App Store, and PayHere says it charges no application or setup fee. You pay per sale instead: PayHere's processing fee, 3.3% for an LKR Visa or Mastercard payment on its LITE plan in PayHere's fee list archived in July 2025, and Shopify's third-party transaction fee, which depends on your Shopify plan.
Both sit in the Integrations section of your PayHere account. PayHere's Shopify instructions have you paste them into the app's settings page in Shopify, set Sandbox Mode, click Save and then Activate PayHere Payment Gateway. A Sandbox account has its own values, and nothing from it carries over to your live account.
Check four things. Your store address in Settings > General must be in Sri Lanka, since Shopify filters its provider list by it. The app must be activated, not just installed. Shopify says only the store owner can add a credit card payment provider. PayHere explains how to remove an old PayHere plugin in Settings > Payments. If all four hold, contact PayHere, which supports the app.
Open a separate PayHere Sandbox account, enter its Merchant ID and Secret in the app and tick Sandbox Mode. PayHere processes no real payments in Sandbox. To go live, enter the Merchant ID and Secret from your live account, untick Sandbox Mode and save. Separately, Shopify says customers can't place live orders while your payment providers are in test mode.
PayHere's fee pages archived July 16, 2025 show LITE at 3.3% with no monthly fee and a Rs.200,000 monthly cap, PLUS at 2.99% plus Rs.3,990 a month, and PREMIUM at 2.69% plus Rs.9,990; they add 0.5% for American Express, Discover and Diners Club and 1.0% for foreign currencies. Add Shopify's fee.
Yes. Shopify adds its third-party transaction fee to every sale paid through a provider other than Shopify Payments: 2% on Basic, 1% on Grow, 0.6% on Advanced and 0.2% on Plus, on top of PayHere's fee. A Rs.10,000 LKR Visa or Mastercard order on PayHere LITE, at its July 2025 rate, and the Basic plan costs Rs.530 in fees.
PayHere's application page, archived in October 2025, says one of its partner banks reviews each business under Central Bank regulations, which takes 1 to 3 days. PayHere says it has no control over the approval or rejection, and a business rejected for its nature can't reapply, so check PayHere's list of refused business models first.
Not by PayHere's application page, archived in October 2025. It lists drop-shipping, print-on-demand and multi-vendor platforms among the business models that can't obtain PayHere services, because of payment regulations and partner bank policies. A store built on those models needs a different provider, so check before you apply, since a business rejected for its nature can't reapply.
Refunds start in your PayHere account: find the payment and click Request Refund. PayHere refunds only in full, only card payments, and free. In countries without Shopify Payments, such as Sri Lanka, Shopify credits back its third-party fee only for refunds made through your Shopify admin, not through a third-party payment gateway. Ask PayHere's support how the two fit.
PayHere's general questions page, archived in October 2025, says online payments settle to your bank account daily on a T+2 cycle, two days after the payment notification. USD payouts need a separate USD PayHere account at 3.99% (PLUS) or 3.69% (PREMIUM), as archived October 7, 2025. That account also needs a USD account at Seylan Bank and a registered business.
PayHere's instructions suggest Shopify Scripts on Plus, but Scripts stopped running on June 30, 2026. Shopify's replacement is a payment customization built with Shopify Functions, which can hide, reorder and rename payment options at checkout. Merchants use one through an App Store app, and Shopify says plan and geographical restrictions apply, so check the app's listing.
About This Article
Shopify Developer & Editorial Director
9+ years with Shopify since 2017

Front-end developer specializing in Shopify since 2017. Experienced in building custom Liquid themes, optimizing storefront performance, and integrating third-party apps. Directs the editorial process behind Ecom Store Pro: sets its topics and the rules every AI-written page must pass before publication.

Some links in this article are affiliate links. If you sign up for a Shopify store through these links, we may earn a commission at no extra cost to you. Read our full advertising policy.

Continue Learning

What to Read Next

Stay updated

Get notified about new articles

Subscribe to receive updates when we publish new Shopify guides and insights.