Skip to main content

GET Products For Your Account

Merchants and sub-merchants can only query products that have been activated under their own account. The Pagamio VAS API exposes one endpoint per account type for this:

Account TypeEndpoint
MerchantGET /merchants/{merchantId}/products
Sub-MerchantGET /sub-merchants/{subMerchantId}/products

Authentication Required: ✅

The {merchantId} / {subMerchantId} path parameter is your own account's ID. You can only retrieve products belonging to your own account; attempts to query another account's products return 403 Forbidden.

You can find your ID in the Pagamio merchant dashboard under My User → Merchants.

Request — Merchant​

GET /api/v1/merchants/{merchantId}/products
Authorization: Bearer <ACCESS_TOKEN>

Request — Sub-Merchant​

GET /api/v1/sub-merchants/{subMerchantId}/products
Authorization: Bearer <ACCESS_TOKEN>

Response​

[
  {
    "id": "P9X8Y7",
    "name": "Vodacom Airtime",
    "code": "AIR-VOD-001",
    "brandId": "V1A2B3",
    "brandName": "Vodacom",
    "minAmount": 5,
    "maxAmount": 1000,
    "fixedAmount": false,
    "pinLess": true
  }
]

Field shapes are illustrative — always treat unknown fields gracefully and rely on documented fields (code, brandId, brandName, minAmount, maxAmount).

Why There Is No Generic GET /products For You​

Product availability is governed at the merchant level. The platform deliberately scopes product listings to your account so that:

  • You only see products you are actually allowed to vend.
  • You cannot enumerate the global catalog or another merchant's catalog.
  • A product that has been deactivated for you immediately disappears from your list without a client release.

For the rule itself and what happens when you attempt to vend a product that isn't active, see Product Availability.

Last updated: April 2026