Make Card Payment

Initiate a card payment transaction effortlessly. Use this endpoint to process card payments. You will need to provide essential details like the service ID, transaction type, amount, and a callback URL for real-time status updates.

POST /make_payment

Make Card Payment

cURL

curl --request POST \
  --url https://api.example.com/make_payment \
  --header 'Content-Type: application/json' \
  --data '
{
  "Authorization": "<string>",
  "service_id": 123,
  "reference": "<string>",
  "transaction_id": "<string>",
  "trans_type": "<string>",
  "amount": 123,
  "nw": "<string>",
  "nickname": "<string>",
  "payment_option": "<string>",
  "currency_code": "<string>",
  "currency_val": "<string>",
  "callback_url": "<string>",
  "landing_page": "<string>",
  "request_time": "<string>"
}
'

200

{
  "response_message": "<string>",
  "response_code": "<string>",
  "redirect_url": "<string>"
}

Authorization

Authorization · string · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Request Body

service_id · integer · required

Your unique service identifier. You’ll receive this when you register your service with us.

reference · string · required

Your internal reference for this payment.

transaction_id · string · required

A unique identifier for this transaction. Ensure this is unique for each request to avoid duplicate transactions. Use this to track the transaction in your system.

trans_type · string · required

The type of transaction. Use ‘CTM’ for customer-to-merchant payments (customer payments).

amount · number · required

The amount to be transacted. Use a decimal point for fractional amounts (e.g., 10.50).

nw · string · required

The network for card payments. Use ‘CRD’ for card payments or ‘CRD’ for both card and mobile money.

nickname · string · required

You can use your service name or the purpose of the transaction as the nickname as this will be shown on the payers phone when they receive the payment request.

payment_option · string · required

The payment method. Use ‘CRD’ for card payments or ‘CRM’ for both card and mobile money.

currency_code · string · required

The currency code for the transaction. For example, use ‘GHS’ for Ghanaian Cedi, ‘USD’ for US Dollars.

currency_val · string · required

The currency value. This is typically the amount in the currency specified in the currency_code unless you’re dealing with a specific exchange rate scenario.

callback_url · string · required

Your URL where we’ll send transaction status updates. Ensure this endpoint is set up to receive POST requests.

landing_page · string · required

Your landing page after the transaction has been completed.

request_time · string · required

The timestamp of your request. Use the format YYYY-MM-DD HH:MM (e.g., ‘2024-06-28 12:46’).

Response

response_message · string

A human-readable message describing the result of the payment initiation.

response_code · string

A code indicating the status of the payment initiation. Refer to our response code documentation for details.

redirect_url · string

The Card payment page to redirect your app or users to for the actual payment.

Example Request

curl -X POST https://api.thebridgesolutions.com/make_payment \
  -H "Authorization: Basic YOUR_ENCODED_CREDENTIALS" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 12345,
    "reference": "REF123456",
    "transaction_id": "TXN987654",
    "trans_type": "CTM",
    "amount": 100.50,
    "nw": "CRD",
    "nickname": "My Store",
    "payment_option": "CRD",
    "currency_code": "GHS",
    "currency_val": "100.50",
    "callback_url": "https://your-domain.com/callback",
    "landing_page": "https://your-domain.com/landing",
    "request_time": "2025-06-28 12:46"
  }'

Example Response

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