Skip to main content

Nigerian Tax Calculator & Compliance Platform - KeepAm

    We use essential cookies to keep things running smoothly. Our analytics are privacy-friendly and don't track you. Learn more

    Live Now

    ATRS (Automated Tax Remittance System): Complete Guide for Nigeria 2026

    ATRS is the NRS live API that lets businesses automate VAT collection, receipt generation, and tax remittance in real time. No more manual filing. Here is everything you need to know.

    Last updated: January 2026

    What is ATRS (Automated Tax Remittance System)?

    Quick Answer

    ATRS (Automated Tax Remittance System) is a live REST API by the Nigeria Revenue Service (formerly FIRS) that enables businesses to automatically collect and remit VAT through their POS systems, e-commerce platforms, or payment gateways. It is accessible at atrs-api.firs.gov.ng and uses OAuth 2.0 authentication. Businesses register through the eCitizen portal at ecitizen.firs.gov.ng.

    Registration Threshold

    ATRS applies to any business using POS systems, e-commerce platforms, or digital payment systems that process VATable transactions. There is no separate turnover threshold. If your business collects payments digitally and those payments include VAT, ATRS integration lets you automate compliance.

    Who Must Register for ATRS (Automated Tax Remittance System)?

    Businesses with POS terminals processing VATable sales
    E-commerce platforms collecting payments for taxable goods or services
    Payment processors and fintech companies handling VATable transactions
    Any business seeking automated, real-time VAT compliance instead of manual filing

    How to Register for ATRS (Automated Tax Remittance System)

    1

    Register on eCitizen Portal

    Create an account at ecitizen.firs.gov.ng. This is the NRS platform for managing API access and business registrations.
    2

    Apply for ATRS API Access

    Submit your ATRS application through the eCitizen portal. You will need your business TIN, CAC details, and a description of your integration use case.
    3

    Obtain OAuth 2.0 Credentials

    Once approved, you receive a Client ID and Client Secret for API authentication. Keep these credentials secure.
    4

    Integrate API Endpoints

    Connect the ATRS REST API to your POS system, e-commerce platform, or payment gateway using the official Swagger documentation.
    5

    Test in Sandbox Environment

    Verify your integration works correctly using the sandbox environment before going live. Test bill creation, receipt generation, and QR codes.
    6

    Go Live with Automated Remittance

    Switch from sandbox to production API at atrs-api.firs.gov.ng. Your VAT collection and remittance is now automated.

    How ATRS Works

    ATRS creates a direct link between your payment system and the Nigeria Revenue Service. Instead of manually calculating and filing VAT each month, the process happens automatically with every transaction.

    1

    Sale Occurs

    A customer makes a purchase through your POS, website, or payment terminal.

    2

    Data Sent via API

    Your system sends the transaction details (amount, VAT, items) to the ATRS API in real time.

    3

    NRS Validates & Issues Receipt

    The NRS validates the data, records the VAT, and returns a receipt with a unique QR code.

    4

    VAT Automatically Tracked

    The VAT is recorded in the NRS system. No need for manual returns. Your records stay audit-ready.

    API Overview

    Technical Summary

    ATRS is a RESTful API hosted at atrs-api.firs.gov.ng. It uses OAuth 2.0 for authentication, MD5 signing for data integrity, and returns JSON responses including QR code data for receipt verification.

    Authentication

    OAuth 2.0 with Client ID and Client Secret. Tokens must be refreshed before expiry. All requests require a valid Bearer token.

    Core Endpoints

    POST endpoints for creating bills and receipts. Each transaction gets a unique identifier and QR code from NRS.

    Data Integrity

    MD5 signing ensures transaction data has not been tampered with between your system and the NRS servers.

    QR Code Receipts

    Every validated transaction returns QR code data. Print this on customer receipts for instant NRS verification.

    Note: Full API documentation (Swagger/OpenAPI) is available after registering on the eCitizen portal. This guide covers the high-level architecture only.

    ATRS vs Manual VAT Filing

    AspectATRS (Automated)Manual Filing
    TimingReal-time with each transactionMonthly, by the 21st
    ProcessAutomatic via API integrationManual calculation and form submission
    ReceiptsQR-coded, NRS-verified instantlyPaper-based, no instant verification
    Audit readinessAlways audit-ready, full digital trailDepends on record-keeping quality
    Error riskMinimal, system-validatedHigh, manual data entry errors
    CostDevelopment/integration cost upfrontOngoing staff time each month

    Who Benefits Most from ATRS

    Retail Businesses

    Shops and supermarkets with POS terminals can automate VAT on every sale. No more end-of-month calculations.

    E-Commerce Platforms

    Online stores and marketplaces can integrate ATRS into checkout flows for automatic VAT compliance on every order.

    Restaurants & Hospitality

    Hotels, restaurants, and event venues with high transaction volumes benefit from automated receipt generation with QR codes.

    Service Providers

    Professional service firms, logistics companies, and B2B providers can automate VAT on invoiced services.

    Official Resources

    Compliance Checklist

    Register on eCitizen portal and obtain API credentials
    Integrate ATRS API endpoints into your POS or payment system
    Implement OAuth 2.0 token management with proper refresh logic
    Generate QR codes on all receipts for NRS verification
    Use MD5 signing for data integrity on all API requests
    Reconcile ATRS transactions with your internal records monthly
    Monitor API response codes and handle errors gracefully
    Keep API credentials secure and rotate them periodically

    Penalties for Non-Compliance

    ViolationPenaltyNotes
    Failure to remit collected VAT100% of unremitted tax + penalty interest-
    Late VAT remittance10% of amount outstanding + interest at CBN rate-
    Failure to issue proper receipts50% of invoice value-
    Incomplete or inaccurate transaction data₦50,000 per occurrence + potential audit-

    Avoid penalties: Set up reminders for all filing deadlines. KeepAm sends automatic notifications before each due date.

    Frequently Asked Questions

    Stay Compliant with KeepAm

    Track all your tax obligations, get deadline reminders, and generate filing-ready reports with KeepAm.