Skip to main content
Welcome to the TagPay Wallet API documentation. TagPay gives your business a complete wallet infrastructure — create customer wallets, process payments, issue cards, and receive real-time notifications, all through a single REST API.

Quick Start

Make your first API call in minutes

Authentication

Get your API keys and authenticate requests

Wallets

Understand how wallets work

API Reference

Explore all available endpoints

​
What you can build

TagPay provides the building blocks for embedded finance experiences:
  • Customer wallets — Create and manage wallets for your end-users, with full credit, debit, and balance controls
  • Bank transfers — Send funds to any Nigerian bank account via NIP
  • Wallet transfers — Move funds instantly between wallets on the platform
  • Card issuance — Issue virtual and physical debit cards to your customers
  • Webhook notifications — Receive real-time events for every transaction and status change
  • KYC verification — Verify customer identity via BVN and NIN lookups

​
How it works

1

Register your merchant account

Sign up and complete your merchant KYC to receive sandbox and production access credentials.
2

Get your API keys

Retrieve your public and private keys from the merchant dashboard. Use these to authenticate every API request.
3

Create customer wallets

Use the Wallets API to provision wallets for your customers. Each wallet gets a unique account number.
4

Process transactions

Credit, debit, and transfer funds. Subscribe to webhooks to receive real-time status updates.

Wallet Management

Create, fund, and manage customer wallets

Funds Transfer

Send money to banks and between wallets

Webhooks

Subscribe to real-time transaction events

Card Issuance

Issue and manage debit cards