> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thebridgesolutions.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Make Payment

> Initiate a payment transaction effortlessly. Use this endpoint to process payments (collections) and payouts/transfers via bank transfer or mobile money. You'll need to provide essential details like the service ID, customer's phone number, transaction type, amount, and a callback URL for real-time status updates.



## OpenAPI

````yaml post /make_payment
openapi: 3.0.0
info:
  title: TheBridge Developer API
  description: >-
    Welcome to TheBridge Developer API! This powerful interface allows you to
    seamlessly integrate our fintech solutions into your applications. With our
    API, you can process bank and mobile money transactions, check account
    balances, and simulate callbacks for testing. Get ready to revolutionize
    your financial operations with our secure and efficient API.
  version: 1.0.0
servers:
  - url: https://{api_host}
    variables:
      api_host:
        default: api.thebridgesolutions.com
security:
  - basicAuth: []
paths:
  /make_payment:
    post:
      summary: Make Payment
      description: >-
        Initiate a payment transaction effortlessly. Use this endpoint to
        process payments (collections) and payouts/transfers via bank transfer
        or mobile money. You'll need to provide essential details like the
        service ID, customer's phone number, transaction type, amount, and a
        callback URL for real-time status updates.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                service_id:
                  type: integer
                  description: >-
                    Your unique service identifier. You'll receive this when you
                    register your service with us.
                customer_number:
                  type: string
                  description: >-
                    The phone number of the customer making the payment. Format:
                    International number without '+' (e.g., '233XXXXXXXXX').
                reference:
                  type: string
                  description: Your internal reference for this payment.
                transaction_id:
                  type: string
                  description: >-
                    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:
                  type: string
                  description: >-
                    The type of transaction. Use 'CTM' for customer-to-merchant
                    payments (customer payments), 'MTC' for merchant-to-customer
                    transfers (merchant payments).
                amount:
                  type: number
                  description: >-
                    The amount to be transacted. Use a decimal point for
                    fractional amounts (e.g., 10.50).
                nw:
                  type: string
                  description: >-
                    The network provider for mobile money transactions. Use
                    'MTN' for MTN Mobile Money, 'TEL' for Telecel Cash and 'AIR'
                    for AirtelTigo Cash etc.
                nickname:
                  type: string
                  description: >-
                    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:
                  type: string
                  description: >-
                    The payment method. Use 'MOM' for mobile money, 'CRD' for
                    card payments.
                currency_code:
                  type: string
                  description: >-
                    The currency code for the transaction. For example, use
                    'GHS' for Ghanaian Cedi, 'USD' for US Dollars.
                currency_val:
                  type: string
                  description: >-
                    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:
                  type: string
                  description: >-
                    Your URL where we'll send transaction status updates. Ensure
                    this endpoint is set up to receive POST requests.
                request_time:
                  type: string
                  format: date-time
                  description: >-
                    The timestamp of your request. Use the format YYYY-MM-DD
                    HH:MM (e.g., '2024-06-28 12:46').
      responses:
        '200':
          description: >-
            Payment initiated successfully. Check the response for details on
            the transaction status.
          content:
            application/json:
              schema:
                type: object
                properties:
                  response_message:
                    type: string
                    description: >-
                      A human-readable message describing the result of the
                      payment initiation.
                  response_code:
                    type: string
                    description: >-
                      A code indicating the status of the payment initiation.
                      Refer to our response code documentation for details.
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````