Skip to main content
Shogun is a Banking-as-a-Service (BaaS) REST API that gives your business access to banking infrastructure — virtual accounts, bank transfers, and real-time inbound collections — through a single, clean API. Whether you’re building a fintech app, marketplace, or payment platform, Shogun handles the banking layer so you can focus on your product.

Quick Start

Get your credentials and make your first API call in minutes

Authentication

Learn how to generate and use bearer tokens for API access

Virtual Accounts

Provision dedicated payment accounts for your customers

Fund Transfers

Send funds to any bank account in Nigeria

Webhooks

Get notified instantly when payments land or transfers complete

Error Reference

Understand response codes and how to handle errors

​
How Shogun works

Shogun exposes two API surfaces depending on how you integrate:
  • Integration API — Server-to-server API authenticated with client_id and client_secret. Use this to provision accounts, move funds, and receive webhooks from your backend.
  • Dashboard API — JWT-authenticated API for managing your Shogun account programmatically: team members, roles, security settings, and preferences.
1

Get your credentials

After your business account is approved, go to Dashboard → Security → API Client to retrieve your client_id and client_secret.
2

Generate a bearer token

Exchange your credentials for a short-lived JWT. Tokens expire after 1 hour — cache and refresh them server-side.
3

Provision a virtual account

Create a dedicated payment account for each of your customers using their BVN or NIN. They can receive payments at that account number permanently.
4

Set up webhooks

Register a webhook URL to receive real-time notifications whenever a payment is collected or a transfer completes.
Shogun operates in two environments: Sandbox (https://shogun-dev.xchangeboxng.com) and Production (https://baasapi.payrepmfb.com). Always test in Sandbox before going live.