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 APART | DETAILS |
|---|---|
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. |
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.
- Gems & Jewellery business
- Unauthorised Software licence business
- Dating services
- Donation platforms
- Betting / Gambling
- Drop-shipping
- Print-on-demand
- Multi-vendor platforms
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
| STEP | WHAT HAPPENS | WHO 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 |
Required Documents
The exact document requirements depend on your business type. The table below outlines what is needed for each category.
| DOCUMENT | INDIVIDUAL / FREELANCER | SOLE 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) |
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
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 METHOD | TYPE | NETWORKS / 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.
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
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.
Other Charges
| CHARGE TYPE | DESCRIPTION |
|---|---|
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 Day | Expected Settlement Day |
|---|---|
Monday | Tuesday (Bank Working Day) |
Friday | Monday (Next Bank Working Day) |
Saturday / Sunday | Tuesday (Next Bank Working Day) |
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 Type | Timeframe | Notes |
|---|---|---|
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.
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 Code | What It Means | Prevention 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)
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.
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
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
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:
| Process | Typical 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
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:
| Consequence | Details |
|---|---|
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. |
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.
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
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
| Factor | 2D (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
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.
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.
On This Page