Nigeria's certified e-invoice API
Yona validates, signs, and submits your invoices to the NRS. Build it into your product with our API — or just chat with Yona on WhatsApp.
Certified access point
Licensed system integrator
1M+ invoices processed
create.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
TypeScript
UTF-8
Ln 20, Col 1
Spaces: 2
Licensed Access Point
System Integrator
Tax Compliant
Built for developers
Everything you need to integrate
Simple REST API
Predictable JSON endpoints. Integrate with any stack in minutes.
Responses under 200ms
OpenAPI 3.0 spec included
Node, Python, PHP & Dart SDKs
Real-time Webhooks
Know the moment the NRS accepts or rejects an invoice. Exponential backoff and delivery tracking included.
Automatic retry on failure
Delivery confirmation
Customizable event filtering
Official SDKs
Type-safe libraries for Node, Python, PHP, and Dart — auto-generated from our OpenAPI spec.
Full TypeScript definitions
Async/await patterns
Idiomatic per-language design
Sandbox & Docs
Full sandbox environment with interactive API playground. Ship your first test invoice in under 5 minutes.
No credit card for sandbox
Complete code examples
Quickstart guides per SDK
Why Yona
Everything you'd spend months building, in one API call.
Nigeria requires businesses to issue invoices electronically to the NRS. Yona is the API infrastructure that connects your software to that network — handling validation, signing, and delivery automatically.
Without Yona
Build and maintain everything yourself
Implement UBL 2.1 schema from scratch
Build cryptographic signing infrastructure
Integrate directly with the NRS's API
Handle validation, retries, and error recovery
Track and adapt to regulatory changes
With Yona
One API call handles everything
POST invoice data to a single endpoint
Validation, signing, and delivery handled automatically
Real-time status updates via webhooks
Regulatory changes applied without code updates
Full audit trail and compliance logging included
Single API
One integration for all e-invoicing requirements
Zero Overhead
We handle UBL, signatures, and validation automatically
Always Updated
Regulatory changes implemented without code updates
Multi-currency
NGN, USD, GBP, and EUR supported out of the box
Compliance
Full regulatory compliance, built‑in
Every invoice is validated, signed, and verified before it reaches the NRS. You get compliant output without writing compliance code.
Schema Validation
Every invoice is validated against the required UBL 2.1 format before it leaves your system. Malformed data never reaches the NRS.
Pre-issuance field checks
Clear error messages
Guaranteed compliant output
Digital Signatures
Invoices are cryptographically signed and timestamped automatically. Certificates managed for you.
Automatic certificate rotation
Tamper-proof verification
Timestamped audit trail
Tax ID Verification
Seller and buyer tax IDs verified against the NRS in real-time before issuance. Bad data caught early.
Real-time the NRS lookup
Seller and buyer checks
Failed verification alerts
Audit Logging
Every invoice event is logged immutably. Export reports anytime, with 7-year retention built in.
Immutable event records
7-year retention
Exportable reports
Information Security
Your data is protected by an information security management system certified to ISO/IEC 27001:2022, the international standard for managing information security.
ISO/IEC 27001:2022 certified
Encrypted in transit and at rest
Independent third-party audit
Data Protection
We handle taxpayer and invoice data under the Nigeria Data Protection Act 2023, registered with the NDPC and verified through an independent compliance audit.
NDPC-registered data controller
NDP Act 2023 audit filed
Data minimization by design
Quick Start
Start sending compliant invoices in minutes
Four simple steps to integrate Nigeria's e-invoicing infrastructure
01
Create account
Sign up in seconds. No credit card required to start testing.
02
Generate API key
Get your sandbox API key instantly from the dashboard.
03
Send first test invoice
Use our SDK or REST API to send your first invoice in minutes.
04
Go live
Switch to production when ready. Start processing real invoices.
On WhatsApp
No new tools, no dashboard to learn — message Yona right inside WhatsApp, from your phone, wherever you are. It collects your invoice details, validates them, signs, and submits to the NRS. Snap a photo of a paper invoice and Yona files it for you.
Accepted by the NRS in seconds — confirmation in the chat
Snap a photo and Yona reads it and submits it
Status, VAT totals, and credit balance — just ask
9:41
Yona
online
Invoice Dangote Ltd — 40 bags of cement at ₦2,000 each
9:41
✓✓
That's ₦80,000 + ₦6,000 VAT (7.5%). Buyer TIN verified. Submit to the NRS?
9:41
Accepted. Reference TAX-8841. PDF attached.
Accepted by NRS
9:41
Message
Pricing
Start free, scale as you grow
No hidden fees. Pay only for what you use. Credits are deducted per action.
Save ~17%
Free
₦0
/ mo
Get started with basic e-invoicing features at no cost
200 monthly credits
1 organization
2 team members
1 seller entity
10 buyer entities
1 API key (test mode only)
1 webhook endpoint
Email notifications
Starter
₦50,000
/ mo
Perfect for small businesses getting started with e-invoicing
5,000 monthly credits
1 organization
5 team members
5 seller entities
50 buyer entities
2 API keys (test + live)
2 webhook endpoints
Email notifications
Live mode API access
Professional
₦200,000
/ mo
For growing businesses with higher invoicing volume
25,000 monthly credits
3 organizations
15 team members
3 custom roles
20 seller entities
500 buyer entities
5 API keys (test + live)
5 webhook endpoints
Email notifications
Live mode API access
Business
₦400,000
/ mo
For established businesses with high invoicing volume
50,000 monthly credits
Unlimited organizations
Unlimited team members
Unlimited custom roles
Unlimited seller entities
Unlimited buyer entities
Unlimited API keys
Unlimited webhooks
Email notifications
Live mode API access
Higher rate limits
Credits per action
Add a buyer
1
Cancel invoice
3
Create invoice
1
Download invoice PDF
1
Query invoice status
1
Submit invoice
5
Validate invoice
1
Bulk report export
1
Add a seller
1
Send SMS
1
Taxpayer lookup
1
Verify tax number
2
Outbound webhook delivery
1
All plans include full API access, sandbox, and SDKs. Need a custom plan?
Ready to go live?
Create a free account, test in sandbox, and go live when you're ready. No credit card required.
Sandbox access included · No credit card required
Not a developer? The Yona dashboard works without code — chat with Yona on WhatsApp is coming soon.