---
title: "Initiate mobile money transfer"
method: POST
path: "/api/v1/bila/transfers/mobile-money"
tags: ["Transfers"]
---

# Initiate mobile money transfer

`POST /api/v1/bila/transfers/mobile-money`

Initiate a transfer to a mobile money account. Creates a transaction record in your dashboard.

## Request body

- MobileMoneyTransferDto
  - `amount` number, required — Transfer amount
  - `reference` string, required — Unique client reference
  - `phone` string, required — Recipient phone number
  - `operator` 'airtel' | 'mtn' | 'zamtel', required — Mobile money operator
  - `country` 'zm', required — Country code
  - `narration` string — Transfer narration
  - `walletId` string, uuid — Source wallet ID to debit (defaults to main wallet if omitted)
  - `recipientName` string — Recipient name for the transaction record

## Response `201`

Transfer initiated successfully

- object
  - `status` boolean, required — Request success status
  - `message` string, required — Response message
  - `data` TransferResponseDto
    - `id` string, required — Transfer ID
    - `reference` string, required — Client reference
    - `type` 'bank-account' | 'mobile-money', required — Transfer recipient type
    - `status` 'pending' | 'successful' | 'failed', required — Transfer status
    - `amount` number, required — Transfer amount
    - `currency` string, required — Currency code
    - `narration` string — Transfer narration
    - `recipient` TransferRecipientDto, required
      - `accountNumber` string — Bank account number (bank-account only)
      - `accountName` string, required — Account holder / recipient name
      - `bankName` string — Bank name (bank-account only)
      - `phone` string — Phone number (mobile-money only)
      - `operator` string — Mobile money operator (mobile-money only)
    - `createdAt` string, date-time, required — Creation timestamp (from Payment)
    - `completedAt` string, date-time — Completion timestamp (from Payment.processedAt)

## Other responses

- `400` — Invalid transfer details

---

[API](https://skmtc.net/bilasdk/apis/bila-payment-gateway-api.md) · [All operations](https://skmtc.net/bilasdk/apis/bila-payment-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bilasdk/bila-payment-gateway-api/revisions/1e6976632889/schema)