Bridge API DocsBridge API Docs
Bridge API Docs

Introduction

Welcome to Bridge Developer API Documentation

Introduction

Welcome to the Bridge Developer API - a comprehensive fintech payment platform for modern applications. Build powerful financial experiences with our secure, developer-friendly API.

What is Bridge API?

Bridge API enables you to integrate financial services into your applications. Accept payments, send payouts, manage wallets, and more - all through a single, unified API.

Integration journey

Bridge follows a sandbox-first onboarding model. You build and test your integration entirely against the sandbox before going live — no real money moves until you are ready.

SandboxProduction
Base URLhttps://api.bridgeagw.comSame
AuthBasic + API keysSame
Money / SMSSimulated — no real chargesReal
Payment recordsIn-memory (~15 min)Persistent
Test numbersRequired allowlist onlyReal MSISDNs / accounts

Phase 1 — Sandbox: Contact TheBridge to receive a sandbox service_id, client_key, and secret_key. Your service will be in mode S. Use the sandbox test numbers and account values documented on each API endpoint page to trigger success and failure scenarios.

Phase 2 — Production: After completing your integration tests and KYC approval, TheBridge issues production credentials. The API host and endpoint paths are identical — only the credentials and real customer numbers change.

Important: Never use sandbox keys or sandbox test numbers in a production environment.

Quick Start

  1. Get sandbox credentials: Contact TheBridge to receive your sandbox service_id, client_key, and secret_key
  2. Set up authentication: Encode client_key:secret_key as Base64 and pass it in the Authorization: Basic header — see Authentication
  3. Test with sandbox data: Use the test numbers and account values on each API endpoint page to validate your integration
  4. Complete KYC: Submit required documents for production approval
  5. Go live: Swap in your production credentials and use real customer numbers

Core Features

Transfer Money / Payout Payment (MTC)

The Payout Payment API allows you to send money to customers via mobile money or bank accounts. This is ideal for:

  • Refunds: Return money to customers for cancelled orders
  • Payouts: Pay sellers, partners, or employees
  • Disbursements: Send loans, claims, or rewards
  • Transfers: Any scenario where you need to send money to customers

Supported Methods

  • Mobile Money: MTN, Telecel, AirtelTigo
  • Bank Transfers: 30+ supported banks (UBA, GCB, Stanbic, Standard Chartered, etc.)
  • Card Payments: Mastercard and Visa

Learn more about Payout Payments →

Documentation

Need Help?

Ready to get started? Begin with Authentication to set up your credentials, then visit the API Reference — every endpoint page includes a Sandbox testing section with copy-paste test values.