Bridge API DocsBridge API Docs
Bridge API Docs
Api reference

Make Payment

Process payments through multiple channels - mobile money, cards, deposits, and payouts

Make Payment

The Bridge API provides a unified payment endpoint that supports multiple transaction types. Choose the payment method that best fits your use case.

Payment Types

Quick Reference

Payment TypeTransaction TypeNetworkUse Case
Mobile MoneyCTMMTN, VOD, AIRCollect payments from customers
Card PaymentCTMCRDSecure card payments with redirect
Deposit WalletDTTWMTN, VOD, AIRFund your wallet for payouts
PayoutMTCMTN, VOD, AIRSend money to customers
Airtime / top-upATPMTN, VOD, AIRSend Airtime API
Bill paymentBLPBill product codes (EPP, DST, …)Bill Payments API

Common Parameters

All payment types share these common parameters:

ParameterTypeRequiredDescription
service_idintegerYesYour service identifier
referencestringYesTransaction reference/description
transaction_idstringYesUnique transaction identifier
amountnumberYesTransaction amount
callback_urlstringYesURL to receive payment notifications
request_timestringYesRequest timestamp

Endpoint

POST https://api.bridgeagw.com/make_payment

Request Headers

Authorization: Basic <base64_encoded_credentials>
Content-Type: application/json

Response Format

All payment types return a consistent response format:

Success Response

{
  "response_message": "Request successfully received for processing",
  "response_code": "202"
}

Card Payment Success (with redirect)

{
  "response_message": "Successful",
  "response_code": "000",
  "redirect_url": "https://cardspaymentpage.com/en/payment/123456789"
}

Error Response

{
  "response_message": "You are not allowed to use this service",
  "response_code": "100"
}

Next steps

Open the guide for your flow (cards above). Validate amounts and identifiers before calling the API, handle errors using response codes, and use callbacks for async status. Questions: support@thebridgesolutions.com.