> ## 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.

# Credit Mobile Wallet / Bank Account

> This endpoint handles payouts to mobile wallets, bank accounts, and cash pick-ups.

<Note>
  * For **Credit Mobile Wallet Transactions**, use `service_type` as `"Wallet"`.
  * For **Bank Account Transactions**, use `service_type` as `"Bank"` for standard bank transfers.
  * For **Cash Pick-up Transactions**, use `service_type` as `"Pickup"` for cash pick-up services.
</Note>


## OpenAPI

````yaml POST /api/payouts
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/payouts:
    post:
      description: >-
        This endpoint handles payouts to mobile wallets, bank accounts, and cash
        pick-ups.
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              oneOf:
                - title: 📱 Mobile Wallet
                  type: object
                  properties:
                    amount:
                      type: integer
                      example: 0.1
                      description: The amount to credit the mobile wallet
                    send_amount:
                      type: integer
                      example: 0.1
                      description: The amount to send
                    sender_country:
                      type: string
                      example: GHA
                      description: The country code of the sender
                    send_currency:
                      type: string
                      example: GHS
                      description: The currency code of the sender
                    sender_first_name:
                      type: string
                      example: Zeepay
                      description: The first name of the sender
                    sender_last_name:
                      type: string
                      example: Ghana
                      description: The last name of the sender
                    receiver_first_name:
                      type: string
                      example: GODWIN
                      description: The first name of the receiver
                    receiver_last_name:
                      type: string
                      example: HOTTOR
                      description: The last name of the receiver
                    service_type:
                      type: string
                      example: Wallet
                      description: The service type
                    receiver_msidn:
                      type: integer
                      description: The receiver mobile number
                    receiver_country:
                      type: string
                      example: GHA
                      description: The country code of the receiver
                    receiver_currency:
                      type: string
                      example: GHS
                      description: The currency code of the receiver
                    transaction_type:
                      type: string
                      example: CR
                      description: The transaction type
                    extr_id:
                      type: string
                      example: guid-example
                      description: The external ID
                    mno:
                      type: string
                      example: MTN
                      description: The mobile service provider
                    callback_url:
                      type: string
                      example: >-
                        https://webhook.site/3b3b3b3b-3b3b-3b3b-3b3b-3b3b3b3b3b3b
                      description: The callback URL (optional)
                  required:
                    - amount
                    - send_amount
                    - sender_country
                    - send_currency
                    - sender_first_name
                    - sender_last_name
                    - receiver_first_name
                    - receiver_last_name
                    - service_type
                    - receiver_msidn
                    - receiver_country
                    - receiver_currency
                    - transaction_type
                    - extr_id
                    - mno
                - title: 🏦 Bank Account
                  type: object
                  properties:
                    amount:
                      type: integer
                      example: 1
                      description: The amount to credit the bank account
                    send_amount:
                      type: integer
                      example: 1
                      description: The amount to send
                    sender_country:
                      type: string
                      example: GHA
                      description: The country code of the sender
                    sender_currency:
                      type: string
                      example: GHS
                      description: The currency code of the sender
                    sender_first_name:
                      type: string
                      example: Zeepay
                      description: The first name of the sender
                    sender_last_name:
                      type: string
                      example: Ghana
                      description: The last name of the sender
                    receiver_first_name:
                      type: string
                      example: GODWIN
                      description: The first name of the receiver
                    receiver_last_name:
                      type: string
                      example: HOTTOR
                      description: The last name of the receiver
                    service_type:
                      type: string
                      example: Bank
                      description: The service type
                    receiver_currency:
                      type: string
                      example: GHS
                      description: The currency code of the receiver
                    receiver_country:
                      type: string
                      example: GHA
                      description: The country code of the receiver
                    transaction_type:
                      type: string
                      example: CR
                      description: The transaction type
                    extr_id:
                      type: string
                      example: guid-example
                      description: The external ID
                    routing_number:
                      type: number
                      example: 123456
                      description: The routing number of the bank
                    account_number:
                      type: number
                      example: 123456789
                      description: The account number of the bank
                    callback_url:
                      type: string
                      example: >-
                        https://webhook.site/3b3b3b3b-3b3b-3b3b-3b3b-3b3b3b3b3b3b
                      description: The callback URL (optional)
                  required:
                    - amount
                    - send_amount
                    - sender_country
                    - sender_currency
                    - sender_first_name
                    - sender_last_name
                    - receiver_first_name
                    - receiver_last_name
                    - service_type
                    - receiver_currency
                    - receiver_country
                    - transaction_type
                    - extr_id
                    - routing_number
                    - account_number
                - title: 💰 Cash PickUp
                  type: object
                  properties:
                    amount:
                      type: integer
                      example: 0.1
                      description: The amount to credit the mobile wallet
                    send_amount:
                      type: integer
                      example: 0.1
                      description: The amount to send
                    sender_country:
                      type: string
                      example: GHA
                      description: The country code of the sender
                    send_currency:
                      type: string
                      example: GHS
                      description: The currency code of the sender
                    sender_first_name:
                      type: string
                      example: Zeepay
                      description: The first name of the sender
                    sender_last_name:
                      type: string
                      example: Ghana
                      description: The last name of the sender
                    receiver_first_name:
                      type: string
                      example: GODWIN
                      description: The first name of the receiver
                    receiver_last_name:
                      type: string
                      example: HOTTOR
                      description: The last name of the receiver
                    service_type:
                      type: string
                      example: PickUp
                      description: PickUp
                    receiver_msidn:
                      type: integer
                      description: The receiver mobile number
                    receiver_country:
                      type: string
                      example: GHA
                      description: The country code of the receiver
                    receiver_currency:
                      type: string
                      example: GHS
                      description: The currency code of the receiver
                    transaction_type:
                      type: string
                      example: CR
                      description: The transaction type
                    extr_id:
                      type: string
                      example: guid-example
                      description: The external ID
                    mno:
                      type: string
                      example: MTN
                      description: The mobile service provider
                    callback_url:
                      type: string
                      example: >-
                        https://webhook.site/3b3b3b3b-3b3b-3b3b-3b3b-3b3b3b3b3b3b
                      description: The callback URL (optional)
                  required:
                    - amount
                    - send_amount
                    - sender_country
                    - send_currency
                    - sender_first_name
                    - sender_last_name
                    - receiver_first_name
                    - receiver_last_name
                    - service_type
                    - receiver_msidn
                    - receiver_country
                    - receiver_currency
                    - transaction_type
                    - extr_id
                    - mno
      responses:
        '200':
          description: Successfully processed the payout request
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: number
                    example: 411
                    description: Static response code indicating the status
                  message:
                    type: string
                    example: Transaction is pending response from a third party
                    description: This is a response message from the third party
                  zeepay_id:
                    type: integer
                    example: 123456
                    description: The Zeepay ID of the transaction
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````