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

# Initiate GHS mobile-money payment (payer-facing)

> Public endpoint (no API key). Call after the payer enters their phone number and network. `depositInstructionId` comes from the `depositInstructions[]` entry with `method = GHS_MOBILE_MONEY` and `requiresAdditionalInput = true` returned by the `createPaymentIntent` GraphQL mutation. The payer then receives a PIN prompt on their phone.




## OpenAPI

````yaml /api-reference/openapi.json post /v1/checkout/mobile-money/{depositInstructionId}/initiate
openapi: 3.0.3
info:
  title: XentFi API
  version: 1.0.0
  description: >-
    API documentation for XentFi.The XentFi API gives you access to pretty much
    all the features you can use on our dashboard and lets you extend them for
    use in your application. It strives to be RESTful and is organized around
    the main resources you would be interacting with - with a few notable
    exceptions.
servers:
  - url: https://api.xentfi.com
    description: Production server
security: []
tags: []
paths:
  /v1/checkout/mobile-money/{depositInstructionId}/initiate:
    post:
      tags:
        - Checkout
      summary: Initiate GHS mobile-money payment (payer-facing)
      description: >
        Public endpoint (no API key). Call after the payer enters their phone
        number and network. `depositInstructionId` comes from the
        `depositInstructions[]` entry with `method = GHS_MOBILE_MONEY` and
        `requiresAdditionalInput = true` returned by the `createPaymentIntent`
        GraphQL mutation. The payer then receives a PIN prompt on their phone.
      operationId: initiateMobileMoney
      parameters:
        - name: depositInstructionId
          in: path
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - phoneNumber
                - networkProvider
              properties:
                phoneNumber:
                  type: string
                  example: '0244000000'
                networkProvider:
                  type: string
                  enum:
                    - MTN
                    - AIRTEL
                    - VODAFONE
      responses:
        '200':
          description: Prompt sent; status is AWAITING_OTP
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      status:
                        type: string
                      instruction:
                        type: string
                      amount:
                        type: string
                      fee:
                        type: string
                      currency:
                        type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.