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

# Send Mobile Money Payment Request

> Debits a mobile wallet with the specified amount



## OpenAPI

````yaml POST /api/pay
openapi: 3.0.1
info:
  title: OpenAPI Plant Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://test.digitaltermination.com
  - url: https://business-sandbox.instntmny.com
security: []
paths:
  /api/pay:
    post:
      summary: Initiate Paymeni Request
      description: Debits a mobile wallet with the specified amount
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                channel:
                  type: number
                  description: The channel code for the mobile wallet provider
                  example: 2
                phone_number:
                  type: number
                  description: The mobile number of the wallet to debit
                  example: '233245519485'
                name:
                  type: string
                  description: The name of the account holder
                  example: Godwin Hottor
                amount:
                  type: number
                  description: The amount to debit the mobile wallet
                  example: 1
                voucher_code:
                  type: string
                  description: required only for Vodafone Cash Transactions
                  example: ''
                callback_url:
                  type: string
                  description: The callback URL (optional)
                  example: ''
              required:
                - channel
                - phone_number
                - name
                - amount
      responses:
        '200':
          description: Request Sent, pending processing
          content:
            application/json:
              schema:
                type: object
                properties:
                  transaction:
                    type: object
                    properties:
                      type:
                        type: string
                        example: Cr
                      merchant_id:
                        type: number
                        example: 5
                      reference:
                        type: string
                        example: 5-234r433434-24e3ed
                      medium:
                        type: string
                        example: MTN Mobile Money
                      amount:
                        type: number
                        example: 1.01
                      amount_details:
                        type: string
                        example: Hello, this is a test debit transaction
                      status:
                        type: string
                        example: '2'
                      status_message:
                        type: string
                        example: Request sent, pending processing
                      sender_details:
                        type: object
                        properties:
                          type:
                            type: number
                            example: 2
                          'no':
                            type: string
                            example: '233245519485'
                          name:
                            type: string
                            example: ZEEPAY GHANA LIMITED
                          token:
                            type: string
                            example: null
                      recipient_details:
                        type: object
                        properties:
                          type:
                            type: number
                            example: 8
                          'no':
                            type: number
                            example: 5
                          name:
                            type: string
                            example: Godwin Hottor
                      description:
                        type: string
                        example: Payment
                      extra:
                        type: string
                        example: Testing
                      api:
                        type: number
                        example: 1
                      callback_url:
                        type: string
                        example: >-
                          https://webhook.site/3b3b3b3b-3b3b-3b3b-3b3b-3b3b3b3b3b3b
                      updated_at:
                        type: string
                        example: '2020-04-14 16:18:31'
                      created_at:
                        type: string
                        example: '2020-04-14 16:18:31'
                      id:
                        type: number
                        example: 26
                  type:
                    type: string
                    example: Success
                  message:
                    type: string
                    example: Transaction Request Successful
      security:
        - bearerAuth: []
      servers:
        - url: https://business-sandbox.instntmny.com
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````