Skip to navigation
PayoutsMarkets

Mozambique Payouts

MZN payouts to M-Pesa mobile wallets

Use this guide when you want to send MZN payouts to recipients in Mozambique. Mozambique supports mobile wallets (M-Pesa).

Overview

  • Currency: MZN
  • Payment location: MOZ
  • Supported rails: Mobile wallet
  • Payment methods:
    • Mobile wallet → paymentMethodId: "mobilemoney", recipient.type: "mobile_money"

Bank transfers are not currently available for Mozambique.

Required fields by rail

Mobile wallet (M-Pesa)

FieldRequiredNotes
phoneNumberYesMSISDN in international format (258 prefix, e.g. 258841234567)
countryYesMOZ
operatorYesUse vodacom
nameNoRecipient name

M-Pesa in Mozambique is operated by Vodacom, so the operator code is vodacom. The mpesa operator code is reserved for Safaricom M-Pesa in Kenya and is not accepted for MOZ.

Top-level required fields for every payout: merchantId, merchantReference, destinationValue (with minorAmount and currency), paymentMethodId, paymentLocation, recipient, sender (see Sender details).

Sender details (required)

Every payout requires a sender object for KYT/KYC screening. fullName, identity, and identityNumber are required; the remaining sender fields are optional but may be required by certain destinations.

FieldRequiredNotes
fullNameYesSender’s full name
identityYesIdentity document type: passport, nationalId, driversLicense, residencePermit, businessRegistrationNumber, or other
identityNumberYesIdentity document number

See Create Payout for the full sender schema.

Example requests

Mobile wallet (M-Pesa)

{
  "merchantId": "your-merchant-id",
  "merchantReference": "PAYOUT-MZ-001",
  "destinationValue": {
    "minorAmount": 250000,
    "currency": "MZN"
  },
  "paymentMethodId": "mobilemoney",
  "paymentLocation": "MOZ",
  "recipient": {
    "type": "mobile_money",
    "phoneNumber": "258841234567",
    "country": "MOZ",
    "operator": "vodacom",
    "name": "Ana Macamo"
  },
  "sender": {
    "fullName": "Jane Smith",
    "identity": "passport",
    "identityNumber": "A12345678"
  }
}

Important notes

  • Operator code: Always use operator: "vodacom" for M-Pesa in Mozambique.
  • Phone number format: Provide the recipient MSISDN with the 258 country code. Local-format numbers are normalised using country; see Mobile Number Format for the full contract.
  • Account validation: Mobile-money account validation is not currently available for Mozambique; see Verification for supported markets.
  • Sandbox: outcomes are selected by the last two digits of the recipient phone number, the same as in every other market — see Payout Trigger Endings.