​
Quickstart Guide

Get up and running with the E-Invoicing API in just a few minutes. This guide will walk you through registering your business, setting up authentication, and creating your first electronic invoice.

​
Prerequisites

Before you begin, ensure you have:
  • Valid business information
  • A valid business email address
  • Basic knowledge of REST APIs
  • A development environment ready
  • Understanding of Universal Business Language (UBL) standards

​
Quick Start

1

Register Your Application

First, register your application here and get your client credentials (client ID and secret)
2

Set Up Authentication

Configure OAuth 2.0 authentication for your requests. Use your client credentials to obtain access tokens for API calls.
Keep your client credentials secure and never expose them in client-side code or public repositories. Access tokens should be refreshed regularly.
3

Access Reference Data

Get reference data like countries, currencies, and tax categories to populate your application forms.
4

Create Your First Invoice

Generate an electronic invoice with automatic IRN (Invoice Reference Number) generation.
The system will automatically generate an IRN (Invoice Reference Number) and QR code for your invoice. Store the IRN for future reference.
5

Transmit Invoice

Send the invoice to your customer using the transmission API.
6

Confirm Invoice Payment

Update the payment status of your invoice when payment is received or processed.
Payment status can be set to PENDING, PAID, or REJECTED. Include a reference number for payment tracking and reconciliation purposes.
7

Request to Go Live

Submit your application for production access after completing testing in the sandbox environment.
  1. Visit the E-Invoice Portal
  2. Sign in to your account or Register if you have no account
  3. Click on the Production tab
  4. Submit your go-live request with the required information:
    • Business information and contact details
    • Integration type (Direct or On Behalf)
    • Redirect URL (if OnBehalf Integration type)
    • Webhook URL (Optional)
After submitting your go-live request through the portal, our team will review your application and contact you within 2-3 business days. Ensure all required business information is accurate and complete.
Important: If you are requesting a Direct Integration (i.e. you are using your own ERP to manage invoices), you will be required to verify yourself by supplying your tax payer email and password. Please visit our portal to learn more about Direct Integration (Trusted Applications) vs On Behalf Integration (Delegated Applications).

​
Next Steps

Now that you’ve created your first invoice, explore these additional features:
Always ensure proper validation and error handling in your implementation. The E-Invoicing API follows UBL standards and Nigerian tax regulations. Regular monitoring and compliance with regulatory requirements are essential for successful e-invoicing implementation.