Skip to main content
New here? Start with the Quickstart guide — you can make your first API call in under 5 minutes.

What is Banking as a Service?

Banking as a Service (BaaS) means you can add real banking features to your own app or website — without becoming a bank yourself. Here is an analogy that makes it concrete: imagine you want to open a restaurant, but building a full commercial kitchen from scratch would take years and cost millions. Instead, you rent space in a shared kitchen that already has everything: the ovens, the health permits, the refrigeration, the suppliers. You bring your recipes, your brand, and your customers — the kitchen handles the infrastructure. UBN BaaS is that shared kitchen. Union Bank holds the banking licence, maintains the core banking systems, and handles the regulatory compliance. You build your product on top — and your customers get real banking features without ever knowing the kitchen exists.

What you can build

Virtual Bank Accounts

Open real Nigerian bank accounts (with real account numbers) programmatically for your customers or your business. Accounts are backed by Union Bank and work with every bank in Nigeria.

Payments

Send money to any Nigerian bank account in real time over the NIP (Nigeria Instant Payment) network. Automate payroll, vendor payments, customer refunds, and more.

Collections

Receive money from customers. Generate unique collection accounts so you always know exactly who paid and how much. Ideal for marketplaces, lending, and savings products.

Identity Verification

Verify your customers are who they say they are. Check BVN (Bank Verification Number), NIN (National Identification Number), and CAC (company registration) through a single API.

Who is this platform for?

You do not need to be a bank or hold a banking licence. You just need a registered Nigerian business and a Union Bank account.
This platform is built for three types of people:
  • Fintech startups — You want to launch a savings app, a lending product, a wallet, or a neobank. You need real accounts and real payments but you do not want to spend two years getting your own banking licence.
  • Businesses embedding banking — You run a marketplace, an e-commerce platform, or a logistics company. You want to pay vendors automatically, collect from customers, or give users their own wallets inside your existing product.
  • Developers — You are the engineer or technical lead responsible for building one of the above. This documentation is written for you, but it is also written to be understandable by your CEO or your finance director.

What would you like to do?

Quickstart

Make your first API call in 5 minutes. No theory — just a working call right away.

Onboarding

Register your company, upload your documents, and get approved to use the platform.

API Reference

Complete reference for every endpoint: request formats, response formats, and error codes.

Products

Deep-dive guides for Virtual Accounts, Payments, Collections, KYC, and Webhooks.

How it works in 3 steps

1

Register and get verified

Create your partner account at sandbox.api.unionbank.ng/register. You will provide your company name, a corporate email address, and your Union Bank account number. We will send you a verification email and review your business documents (a process called KYB — Know Your Business). This takes 1 to 3 business days.
2

Test in the Sandbox

Once approved, you receive a sandbox API key. The sandbox is a practice environment that behaves exactly like the real system — but no real money moves. You can create accounts, simulate payments, trigger webhooks, and test edge cases freely. There is no time limit and no cost.
3

Go Live

When you are ready to handle real transactions, submit your go-live request from the dashboard. We review your integration, confirm your security setup, and issue your production keys. Real money starts flowing — and real customers can use your product.
Most partners spend 1 to 2 weeks in sandbox before going live. The better you test, the smoother your launch. We provide a Go-Live Checklist so nothing gets missed.

A note on how these docs are organised

These docs follow a structure designed to match how you will actually use the platform:
SectionWhat it coversBest for
Getting StartedIntroduction, Quickstart, Key Concepts, GlossaryEveryone — read this first
OnboardingRegistration, document upload, KYB, going liveBusiness owners and compliance leads
ProductsHow each product works, with code examplesDevelopers building features
API ReferenceEvery endpoint, every field, every error codeDevelopers during active coding
Security & ComplianceAuthentication, NDPR, rate limitsSecurity engineers and CTOs
ResourcesSandbox guide, Postman collection, changelogDevelopers and QA teams
Never use your production API keys in test code. Production keys connect to the live banking system where real money moves. If a test goes wrong with a production key, a real transaction happens. Always use sandbox keys (they start with ubn_sb_) during development.

Ready to begin? Make your first API call →