Payments

Payment methods

List your active MoMo numbers and per-provider instructions.

Use this to render payment options in your own checkout. The response can be cached — payment methods rarely change.

Bash

GET /v1/merchant/payment-methods

Scope: any valid API key.

Response

JSON

{
  "success": true,
  "data": [
    {
      "provider": "momo_mtn",
      "provider_name": "MTN MoMo",
      "phone_number": "0241234567",
      "merchant_code": "123456",
      "account_name": "Kofi's Shop",
      "short_code": "*170#",
      "instructions": [
        "Dial *170#",
        "Select 'Transfer Money'",
        "Choose 'MoMo User'",
        "Enter phone number: {phone}",
        "Enter amount: {amount}",
        "Enter reference: {hpn_code}",
        "Confirm with your PIN"
      ]
    }
  ]
}

Field	Description
`provider`	`momo_mtn`, `momo_telecel`, or `momo_at`
`provider_name`	Display label
`phone_number`	MoMo number in `0XXXXXXXXX` format
`merchant_code`	Provider-specific merchant code, may be `null`
`account_name`	Account holder
`short_code`	USSD shortcode
`instructions`	Step-by-step list. Replace `{phone}`, `{amount}`, `{hpn_code}`.

Reference

Initialize a payment →

Alternative

Use hosted checkout →