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
Mobile Money Payment
Collect payments from customers via MTN, Vodafone, and AirtelTigo mobile money
Card Payment
Process secure payments via credit and debit cards with payment pages
Payout Payment
Send payments to customers via mobile money (refunds, payouts, rewards)
Deposit to Wallet
Fund your transfer wallet using mobile money for future payouts
Quick Reference
| Payment Type | Transaction Type | Network | Use Case |
|---|---|---|---|
| Mobile Money | CTM | MTN, VOD, AIR | Collect payments from customers |
| Card Payment | CTM | CRD | Secure card payments with redirect |
| Deposit Wallet | DTTW | MTN, VOD, AIR | Fund your wallet for payouts |
| Payout | MTC | MTN, VOD, AIR | Send money to customers |
Common Parameters
All payment types share these common parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
service_id | integer | Yes | Your service identifier |
reference | string | Yes | Transaction reference/description |
transaction_id | string | Yes | Unique transaction identifier |
amount | number | Yes | Transaction amount |
callback_url | string | Yes | URL to receive payment notifications |
request_time | string | Yes | Request timestamp |
Endpoint
POST https://api.bridgeagw.com/make_paymentRequest Headers
Authorization: Basic <base64_encoded_credentials>
Content-Type: application/jsonResponse 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"
}Getting Started
- Choose Your Payment Type: Select the payment method that fits your use case
- Review Documentation: Read the specific documentation for your chosen payment type
- Implement Integration: Use the provided code examples to integrate
- Test Thoroughly: Test with small amounts before going live
- Handle Callbacks: Implement webhook handling for payment notifications
Best Practices
- Use Appropriate Transaction Types: Choose the right
trans_typefor your use case - Validate Inputs: Always validate amounts and phone numbers before sending
- Handle Errors: Implement comprehensive error handling
- Monitor Transactions: Use callbacks to track payment status
- Test First: Always test with small amounts in sandbox mode
Support
Need help choosing the right payment type? Contact our support team at support@thebridgesolutions.com or check our detailed documentation for each payment method.