Search Documentation

Search across all documentation pages, APIs and guides.

OnePay Docs

Explore the capabilities of OnePay through our user-friendly documentation. For developers, our comprehensive API documentation provides clear guidance and code samples for easy integration.

Account Setup

Create your OnePay account, set up business details, and start accepting payments in minutes.

Developers

Start building with our simple APIs for Payments, Tokens, and more. Built for scale and speed.

No Code Tools

Invoicing, payment links, POS and more. OnePay's tools work out of the box so you can launch fast.

Integrations

Connect OnePay to Shopify, WooCommerce, WHMCS and other platforms with our seamless plugins.

About OnePay

Our Story

OnePay was launched in 2021 by Spemai (Pvt) Ltd, a technology company backed by a reputed Japanese corporate investor since 2019. What began as a bold idea to modernise digital payments in Sri Lanka has grown into the country's most trusted and scalable payment infrastructure. In just four years, OnePay has crossed LKR 10 billion in payment volume, onboarded 4,500+ active merchants, and earned the distinction of being Sri Lanka's first payment gateway to achieve ISO 27001 certification, the global gold standard for information security.

Our Vision

To transform the future of finance and digital services by building intelligent, inclusive, and accessible solutions that empower businesses and people globally.

Our Mission

To innovate and deliver cutting-edge fintech and AI-powered platforms that simplify payments, automate financial operations, and enhance customer experiences across emerging markets.

Why OnePay?

WHAT SETS US APARTDETAILS
Lowest Monthly Fee
Starting at just LKR 499/month, more affordable than any competitor.
Global Card Networks
Directly integrated with Visa, Master, Amex, Dinners Club, Discover and UnionPay.
Multi-Channel Payments
Cards, mobile wallets - all in one.
Plug-in Ready
Native plugins for Shopify, WooCommerce, WHMCS, Odoo and more.
Developer Friendly
Clean RESTful APIs, iOS & Android SDKs, OnePay JS for embedded checkout.
No-Code Billing
OnePay Billing for subscriptions, recurring payments & automated invoicing.
4+ Years of Trust
Over LKR 10B processed · 4,500+ merchants · growing every day.

Who Can Use OnePay?

OnePay is built for a wide spectrum of Sri Lankan businesses. Whether you are a freelancer just starting out or a publicly listed company processing thousands of transactions a day, OnePay has a plan and a path for you.

Supported Business Types

Individuals (Freelancers & Professionals)
Designers, consultants, tutors, developers, and other independent professionals.
Sole Proprietorships
Single-owner businesses registered in Sri Lanka.
Partnerships
Formally registered partnership businesses.
Clubs & Societies
May have compliance restrictions; approval process may vary.
Limited Liability Companies (Pvt Ltd)
Most straightforward approval path for incorporated businesses.
Publicly Quoted Companies (PLC)
Full enterprise support with dedicated relationship management.
IMPORTANT: Clubs & Societies may have additional compliance requirements. Required documents and approval processes may vary depending on the business type.

Register business with OnePay partners: Click here.

Restricted Business Categories

Certain business types and models are not eligible for OnePay services due to card network compliance requirements and regulatory guidelines.

Unsupported Business Categories
  • Gems & Jewellery business
  • Unauthorised Software licence business
  • Dating services
  • Donation platforms
  • Betting / Gambling
Unsupported Business Models
  • Drop-shipping
  • Print-on-demand
  • Multi-vendor platforms
NOTE: If you are unsure whether your business qualifies, please reach out to our team at support@onepay.lk before starting the onboarding process. We are happy to guide you.

Getting Started - The Onboarding Journey

Getting set up with OnePay is straightforward. We've designed the process to be paperless, fast, and fully guided. Here is exactly what to expect from the moment you decide to move with OnePay.

The 5-Step Onboarding Flow

STEPWHAT HAPPENSWHO DOES IT
1
You decide to join OnePay and contact our team or reach out through the website
You
2
We send you a document checklist. You gather and submit the required documents
You + OnePay Team
3
We review your documents and prepare the merchant agreement
OnePay Team
4
We send a digital signature request. You sign electronically or request a physical PDF copy from your Relationship Officer
You
5
We submit your application and website to the Bank for card network compliance clearance. Approval takes a maximum of 3 working days
OnePay Team
✓ TIP: Once everything is approved, we will notify you immediately. The maximum turnaround time from submission to live approval is 3 working days.

Required Documents

The exact document requirements depend on your business type. The table below outlines what is needed for each category.

DOCUMENTINDIVIDUAL / FREELANCERSOLE PROP.PVT LTD / PLC
National Identity Card (NIC) copy
Passport (if non-citizen)
Business Registration Certificate
Certificate of Incorporation (Form 01)
Memorandum & Articles of Association / Board Resolution for Payment Gateway
(OnePay has a template)
Director / Partner NIC copies
Director / Partner Email address
Director / Partner contact number
Bank Account details (Bank verification document / Online banking statement)
* Must contain Bank Logo, Bank name, Account holder name, Account number (Less than 3 months old)
Utility Bill or Address Proof
(For Passport holders: billing proof from Electricity/Water or Gramasewaka address verification)
Website or Social media page with pricing plan
Gramasewaka Certificate
Recent Education Qualification
(Only for education category - should be in the same stream)
Policies (Refund policy, Return policy, Privacy Policy)
NOTE: Not sure what to submit? Contact your dedicated Relationship Officer and they will walk you through exactly what is needed for your specific business structure.

Website Requirements Before Compliance Review

Before OnePay can submit your application to the Bank for card network clearance, your website must have the following three policy pages in place. This is a mandatory requirement from the card networks (VISA, Mastercard, etc.) and is not optional.

1. Refund Policy

Your refund policy must clearly state the conditions under which customers can receive a refund, the refund timeframe, and the process to initiate it. It should be easy to find from your homepage or checkout page.

2. Privacy Policy

Must explain what personal data you collect, how you use it, and how it is stored. This is also required under Sri Lanka's Personal Data Protection Act.

3. Return Policy

If you sell physical products, outline conditions for returns and the return window (e.g., 14 days). Clearly state if the customer or merchant bears the return shipping cost.

Download sample policies: Click

IMPORTANT: These three policies must be live on your website before OnePay submits your application for card network compliance review. Compliance review is handled entirely by OnePay on your behalf — you just need the policies in place.
✓ TIP: Need help drafting these policies? Our team can point you to free, customisable policy templates used by thousands of Sri Lankan merchants. Just ask your Relationship Officer.

Payment Options & Currencies

OnePay gives your customers multiple ways to pay — making it easier to convert every visitor into a paying customer.

Supported Payment Methods

PAYMENT METHODTYPENETWORKS / PROVIDERS
Debit & Credit Cards
Card Payment
VISA · Mastercard · AMEX · Diners Club · Discover and UnionPay
Mobile Wallets
Mobile Payment
Frimi, Qplus, HelaPay

Supported Currencies

OnePay processes payments in Sri Lankan Rupees (LKR) for all domestic transactions. For merchants serving international customers, cross-border payment support is available. Please contact your Relationship Officer for more details on enabling multi-currency setups.

Please note that, as per guidelines issued by CBSL, Sri Lankan-based businesses are not permitted to accept USD payments from domestic customers. It is important to comply with these regulations to avoid any potential penalties.

For more information, please refer to the official CBSL notice:https://www.cbsl.gov.lk/sites/default/files/cbslweb_documents/press/pr/press_20260212_foreign_currency_transactions_between_residents_of_srilanka_e.pdf

Pricing & Charges

OnePay believes in simple, transparent pricing. No hidden fees. No surprises. Here is everything you need to know.

Monthly Subscription

Starting from LKR 499 / month

The most competitive rate for a compliant, full-featured payment gateway in Sri Lanka

Merchant Discount Rate (MDR)

In addition to the monthly subscription, a Merchant Discount Rate (MDR) applies to each transaction. The MDR is a small percentage of the transaction value retained to cover card network fees, bank processing costs, and platform maintenance. Your specific MDR will be confirmed in your merchant agreement and depends on your business category and transaction volume. Speak to your Relationship Officer for a personalised rate.

✓ TIP: The higher your monthly transaction volume, the more room there is to negotiate a better MDR. As your business scales, reach out to your Relationship Officer to review your rate.

Other Charges

CHARGE TYPEDESCRIPTION
Setup Fee
Approximately LKR 1,500. This is required prior to proceeding with the application and agreement. The fee will be refunded if card network compliance is not approved.
Subscription Payment
Based on the selected package.

Payouts & Settlement

Payouts (also called settlements) refer to the transfer of funds from your OnePay account to your registered business bank account. OnePay ensures that your earnings are settled reliably according to a predefined schedule.

Standard Payout Schedule

The standard payout cycle for merchants on OnePay is T+1 (Transaction day plus one bank working day). This means funds processed on Monday are typically settled to your bank account by Tuesday evening.

Transaction DayExpected Settlement Day
Monday
Tuesday (Bank Working Day)
Friday
Monday (Next Bank Working Day)
Saturday / Sunday
Tuesday (Next Bank Working Day)
NOTE
Payouts are processed only on bank working days in Sri Lanka. Public holidays, mercantile holidays, and weekends are not considered working days for settlement purposes.

Minimum Payout Balance

To ensure efficiency, OnePay processes payouts only when your settled balance exceeds a minimum threshold. By default, this threshold is LKR 1,000. If your balance is below this, it will roll over to the next settlement cycle until the threshold is reached.

Refund Process

Handling refunds professionally and promptly is one of the most effective ways to maintain customer trust and avoid chargebacks. OnePay makes the refund process simple.

When Should You Issue a Refund?

A refund should be issued when:

  • 1. The customer did not receive the product or service they paid for
  • 2. The product or service delivered was significantly different from what was described
  • 3. A duplicate payment was made in error
  • 4. The customer cancelled before fulfilment and is entitled to a refund per your policy
  • 5. A technical error caused an incorrect charge
  • 6. Item out of stocks

How to Process a Refund

Refunds can be initiated directly from your OnePay merchant dashboard. The process is as follows:

7
Log in to your OnePay Merchant Dashboard
8
Navigate to Transactions and locate the transaction to be refunded
9
Click Refund and enter the refund amount (full or partial refunds are supported)
10
Submit the refund request, it is reviewed and processed by OnePay
11
The customer receives the refund to their original payment method within the standard processing time

Refund Processing Timeframes

Refund TypeTimeframeNotes
Standard Refund
3-5 bank working days
Funds returned to customer's original payment method
Mobile Wallet Refund
(Frimi, Qplus and Helapay)
3-5 bank working days
Returned to the original wallet

What if There Are No Funds in Your Payout Account?

If your future payout balance or recent transaction volume is insufficient to cover the refund amount, OnePay will contact you and request that you deposit the required funds to initiate the refund

  • For local (LKR) transactions: you deposit the exact refund amount to the OnePay designated account.

  • For foreign currency transactions: you must deposit the equivalent amount in LKR, calculated at the applicable FX rate on the date the refund is being processed. OnePay will provide you with the account details and the applicable FX rate at that time.

When Refunds Take Longer Than Expected

On rare occasions, refunds may take significantly longer than the standard timeframe due to bank reconciliation issues on the card issuer's side. In these cases, OnePay has no direct authority to follow up with the card-issuing bank on the cardholder's behalf.

If a refund has not appeared within the stated timeframe and the standard resolution steps have been exhausted, the cardholder should initiate a chargeback directly through their card-issuing bank.

A step-by-step guide on how to initiate a chargeback.

✓ TIP
Pro tip: Responding to refund requests within 24 hours significantly reduces the chance of a customer escalating to a chargeback, which is more costly and time-consuming for everyone.

Understanding Chargebacks

A chargeback is when a customer contacts their bank or card issuer to dispute a transaction and request a forced reversal of funds bypassing the merchant entirely. Chargebacks are one of the most serious issues a merchant can face, and understanding them is essential.

How a Chargeback Happens

Here is the typical chargeback flow:

11
Customer disputes a transaction with their bank (e.g., claims they never received goods, or did not authorise the payment)
12
The issuing bank raises a chargeback and contacts OnePay through the card network
13
OnePay notifies you and requests evidence to dispute the chargeback
14
You submit evidence (order confirmation, delivery proof, customer communication, etc.)
15
The card network reviews the evidence and makes a final decision
16
If the decision favours the customer, the transaction amount plus a chargeback fee is debited from your account

Common Chargeback Reasons

Reason CodeWhat It MeansPrevention Strategy
Item Not Received
Customer claims they never got what they paid for
Always issue a tracking number; confirm delivery
Item Not As Described
Product or service differed from what was advertised
Use accurate, detailed product descriptions and images
Unauthorised Transaction
Customer claims they did not make the purchase
Enable 3D Secure (OTP) for all card payments
Duplicate Transaction
Customer was charged twice for the same item
Implement duplicate payment detection in your checkout
Subscription Cancelled
Customer was charged after cancelling a subscription
Ensure cancellation confirmations are sent immediately

How to Win a Chargeback Dispute

Evidence is everything. When OnePay notifies you of a chargeback, compile the following as quickly as possible:

  • Order confirmation with date, amount, and product/service details
  • Proof of delivery (courier tracking, digital delivery logs)
  • Customer communication (emails, WhatsApp messages accepting delivery)
  • Terms & conditions shown at checkout (including your refund and return policy)
  • IP address and device fingerprint of the transaction (available from your dashboard)
WARNING
The chargeback response window is typically 7-14 days from the date of notification. Missing this deadline means an automatic loss. Set up email alerts in your OnePay dashboard to ensure you never miss a notification.

Chargeback Ratio - Keep It Low

Card networks (VISA, Mastercard) set strict thresholds for acceptable chargeback ratios. If your monthly chargeback rate exceeds these thresholds, your account may be flagged, suspended, or your merchant agreement terminated. The standard industry threshold is below 1% of monthly transactions.

IMPORTANT
If your chargeback ratio starts climbing, contact OnePay immediately. We can work with you on fraud prevention settings, 3D Secure configuration, and customer communication strategies to bring the rate down.

Business Verification & Compliance

OnePay is committed to operating within Sri Lanka's financial regulations and global card network standards. Part of this commitment involves periodic business verification for all merchants on the platform.

Periodic Verification

OnePay may request updated business documents from you periodically, typically annually or when significant changes occur in your business. You will be notified in advance with a clear checklist of what is required and a reasonable deadline. Common triggers for a periodic verification request include:

  • Annual KYB (Know Your Business) review
  • Change in business ownership or directorship
  • Change in business address or bank account
  • Significant increase in transaction volume
  • Expansion into new product categories
IMPORTANT
Failing to respond to a verification request within the specified deadline may result in a temporary hold on your payout or account suspension. Always respond promptly to keep your account in good standing.

Approval Scope - What OnePay Approves

It is important to understand that OnePay's approval covers only the initial business operations as declared in your merchant application and agreement. Your approval is scoped to the specific business type, product categories, and transaction nature you described during onboarding.

OnePay continuously monitors transaction activity on the platform. If transactions are identified that fall outside the agreed scope of your approved business operations, OnePay will flag those activities. This may result in:

  • A formal notice requesting clarification on the nature of the transactions
  • A temporary hold on your payout pending review
  • Suspension of your merchant account while the matter is investigated
  • In serious cases, termination of your merchant account
IMPORTANT
Your approval is tied to what you declared at onboarding. If your business evolves, new products, new services, new business models always inform your Relationship Officer before processing those transactions. Getting ahead of this is far simpler than resolving a compliance issue.

Processing Time & Status

You can track the status of your application and any pending verification at any time through your OnePay merchant dashboard or by contacting your Relationship Officer. Standard processing times are:

ProcessTypical Timeframe
New merchant application to live approval
Maximum 3 working days (from complete submission)
OnePay new approval
Maximum 1 working day
New Bank account add or change
Maximum 2 working day
Refund processing (standard)
3-5 bank working days
Chargeback dispute response window
Based on the Cardnetwork time frame

Account Termination

OnePay reserves the right to terminate a merchant account in the following circumstances:

  • Repeated breach of the merchant agreement terms
  • Sustained <DocStrong>high</DocStrong> chargeback or fraud ratio exceeding card network thresholds
  • Discovery that the business falls into a restricted category
  • Failure to comply with document verification requests
  • Fraudulent activity or misrepresentation
  • Transacting outside the approved scope of business operations

In most cases, OnePay will attempt to work with the merchant to resolve the issue before proceeding to termination. If your account is at risk, you will receive a formal notice with a defined cure period.

Consequences of Termination - What You Must Know

WARNING This is one of the most important sections in this guide. Please read it carefully.

If a merchant account is terminated due to a compliance breach or policy violation, the consequences extend far beyond losing access to OnePay. Here is what happens:

ConsequenceDetails
Card Network Notification
OnePay is required to notify the relevant card networks (Visa, Mastercard, etc.) of the termination. This is a mandatory obligation under card network compliance rules.
Business Flagging
The card networks will flag your business in their global merchant databases. This flag is shared across all payment processors and acquiring banks worldwide.
Director & Owner Impact
All directors and owners of the business will be personally impacted. Their names and identification details are linked to the flagged business record.
Future Gateway Applications
The flag significantly affects, and in most cases prevents the directors and owners from successfully applying for a payment gateway with any other payment processor or acquiring bank in Sri Lanka and internationally.
Bank Payment Gateway Access
Bank-issued payment gateways are also subject to the same card network compliance databases. A flagged record will affect applications to bank payment gateway services as well.
WARNING
A termination flag is not a local issue — it travels with your business and your personal identity globally through the card network compliance systems. The best protection is simple: always operate within your approved business scope, maintain a low chargeback rate, and communicate proactively with your Relationship Officer when anything changes.
NOTE
If you receive a termination notice and believe it is in error, contact our support team at info@onepay.lk within 5 business days. We will review the case and respond within 3 business days.

3D Secure - How OnePay Protects Every Transaction

All transactions processed through OnePay are secured using 3D Secure (3DS) authentication. OnePay does not support 2D (non-authenticated) transactions under any circumstances. Understanding the difference between 3DS and 2DS is important for both merchants and customers.

What is 2D (Non-Authenticated) Payment?

A 2D transaction also called a non-3DS or card-not-present transaction is a basic payment where the customer enters their card number, expiry date, and CVV. There is no additional identity verification step. The payment is either approved or declined purely based on card data.

  • No additional authentication required from the cardholder
  • Faster checkout experience with fewer steps
  • Higher fraud risk: stolen card details can be used to make purchases
  • In the event of fraud, the liability falls on the merchant

What is 3D Secure (3DS)?

3D Secure is a global authentication protocol developed by the card networks (Visa calls it Verified by Visa; Mastercard calls it Mastercard Identity Check). It adds an additional verification step after the customer enters their card details, typically a One-Time Password (OTP) sent to their registered mobile number by their issuing bank.

  • The customer enters their card number, expiry date, and CVV
  • The issuing bank sends a one-time password (OTP) to the customer's registered mobile number
  • The customer enters the OTP to authenticate the payment
  • Only after successful OTP verification does the transaction proceed
QUICK FACT
OnePay mandates 3DS for ALL transactions. There are no exceptions. This protects you as a merchant from fraudulent transactions and liability disputes.

3DS vs 2DS - Risk Comparison

Factor2D (Non-Authenticated)3D Secure (3DS)
Authentication
Card details only (no OTP)
OTP verification via issuing bank
Fraud Risk
High: stolen cards can be used freely
Low: requires access to cardholder's phone
Liability on Fraud
Merchant bears full liability
Liability shifts to the issuing bank
Chargeback Exposure
High: merchant must defend all disputes
Significantly reduced: bank-authenticated transactions are harder to dispute
Customer Experience
Faster (fewer steps)
Slightly more steps but much safer
OnePay Support
Not supported
Mandatory for all transactions

3DS Enabled vs Disabled Cards

Not all cards have 3DS enabled. The decision to enable or disable 3DS on a card rests entirely with the card-issuing bank, not with OnePay or the merchant.

Cards with 3DS Disabled

Some issuing banks disable 3DS authentication on certain cards or for certain transaction types. Common scenarios include:

  • Certain international cards where 3DS adoption is limited
  • Specific card products designed for certain transaction categories
  • Corporate or prepaid cards where OTP-based authentication is not configured

Who Bears the Risk When 3DS is Disabled?

When a card does not support 3DS and a transaction is completed without authentication, the liability for any resulting fraud or dispute does NOT fall on the merchant. In this scenario:

  • The card-issuing bank assumes full liability for the transaction
  • The merchant is protected from chargebacks arising from fraudulent use
  • This is a deliberate liability-shift policy enforced by Visa and Mastercard
✓ TIP
As a merchant on OnePay, you are never required to take action based on whether a customer's card has 3DS enabled or disabled. OnePay's system automatically handles the authentication flow.
NOTE
If a customer did not receive an OTP during checkout, this is most likely a 3DS configuration issue with their issuing bank not an OnePay issue. Ask the customer to contact their bank to enable 3DS, or to try a different card.