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

# Initiate Collection

> Initiates a mobile money collection request to fund the merchant's wallet.



## OpenAPI

````yaml post /v1/funding
openapi: 3.0.3
info:
  title: meCash API
  version: 3.0.3
  description: >-
    API for meCash services, including FIAT and Ramp operations. This is the
    OpenAPI specification for the meCash API, covering all available endpoints
    for wallet management, currency quotes, and payouts.


    It follows a design-first approach based on OpenAPI 3.0.


    Authentication is handled via an API key passed in the `x-api-key` header.
    Replace `YOUR_API_KEY` with your actual key when making requests.


    Some useful links:

    - [meCash Documentation](https://docs.me-cash.com/)

    - [Authentication Guide](https://docs.me-cash.com/authentication)
servers:
  - url: https://sandboxapi.me-cash.com
    description: Sandbox Server for Testing
security:
  - ApiKeyAuth: []
tags:
  - name: Wallet
    description: Wallet management operations
  - name: Quote
    description: Currency quote operations
  - name: Payout
    description: Payout operations
  - name: Transaction
    description: Transaction management
  - name: Virtual Account
    description: Virtual account operations for static and dynamic accounts
  - name: Bank
    description: Bank account and list operations
  - name: Ramp
    description: Ramp operations for crypto
  - name: Miscellaneous
    description: Utility and miscellaneous operations
  - name: Collection
    description: Mobile money and wallet funding operations
  - name: Bulk Payout
    description: >-
      Bulk transfer operations for sending to multiple beneficiaries in a single
      request
paths:
  /v1/funding:
    post:
      tags:
        - Collection
      summary: Initiate Collection
      description: >-
        Initiates a mobile money collection request to fund the merchant's
        wallet.
      operationId: initiateFunding
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MobileMoneyFundingRequest'
            example:
              currency: MWK
              country: MW
              amount: 100
              mobile:
                number: '+265123456789'
                provider: Airtel Money
              paymentMethod: MOBILE_MONEY
      responses:
        '200':
          description: Funding transaction initiated successfully.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Success'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/MobileMoneyFundingResponseData'
              example:
                message: fund transaction initiated successfully
                status: success
                data:
                  referenceNumber: Q1PEGKO4QFRRR
                  uniqueReference: ad33948f-68fd-4279-8d5c-651f43ec294a
                  transactionId: be6a81e7-59f3-406b-9d92-a615e8ccfb4c
                  paymentMethod: MOBILE_MONEY
                  amount: 100
components:
  schemas:
    MobileMoneyFundingRequest:
      type: object
      required:
        - currency
        - country
        - amount
        - mobile
        - paymentMethod
      properties:
        currency:
          type: string
          description: Currency code (e.g., MWK, RWF, KES).
          example: MWK
        country:
          type: string
          description: Country code (e.g., MW, RW, KE).
          example: MW
        amount:
          type: number
          example: 100
        mobile:
          type: object
          required:
            - number
            - provider
          properties:
            number:
              type: string
              example: '+265123456789'
            provider:
              type: string
              example: Airtel Money
        paymentMethod:
          type: string
          enum:
            - MOBILE_MONEY
          example: MOBILE_MONEY
    Success:
      type: object
      properties:
        status:
          type: string
          example: success
        message:
          type: string
          example: Operation completed successfully.
        data:
          type: object
          description: The payload of the successful response.
      required:
        - status
        - message
    MobileMoneyFundingResponseData:
      type: object
      properties:
        referenceNumber:
          type: string
          example: Q1PEGKO4QFRRR
        uniqueReference:
          type: string
          example: ad33948f-68fd-4279-8d5c-651f43ec294a
        transactionId:
          type: string
          example: be6a81e7-59f3-406b-9d92-a615e8ccfb4c
        paymentMethod:
          type: string
          example: MOBILE_MONEY
        amount:
          type: number
          example: 100
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````