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.
| Sandbox | Production | |
|---|---|---|
| Base URL | https://api.bridgeagw.com | Same |
| Auth | Basic + API keys | Same |
| Money / SMS | Simulated — no real charges | Real |
| Payment records | In-memory (~15 min) | Persistent |
| Test numbers | Required allowlist only | Real 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
- Get sandbox credentials: Contact TheBridge to receive your sandbox
service_id,client_key, andsecret_key - Set up authentication: Encode
client_key:secret_keyas Base64 and pass it in theAuthorization: Basicheader — see Authentication - Test with sandbox data: Use the test numbers and account values on each API endpoint page to validate your integration
- Complete KYC: Submit required documents for production approval
- Go live: Swap in your production credentials and use real customer numbers
Core Features
📱 Mobile Money Payments
Accept payments via MTN, Telecel, and AirtelTigo mobile money
💳 Card Payments
Process secure credit and debit card payments
💰 Transfer Money / Payout Payment (MTC)
Send money to customers via mobile money or bank accounts
🏦 Wallet Management
Fund and manage your transfer wallet
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
🔐 Authentication
Learn how to authenticate your API requests
📖 API Reference
Complete API endpoint documentation
🔔 Callbacks
Set up webhooks for real-time notifications
📊 Response Codes
Understand API responses and errors
🛒 WooCommerce Plugin
Ready-to-use plugin for WooCommerce
Need Help?
- Support Email: support@thebridgesolutions.com
- Documentation: Browse our comprehensive guides and examples
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.