Product Availability
The Pagamio VAS catalog contains hundreds of products across many categories and brands. Not every product is available to every merchant. Each merchant has an explicitly activated subset of the global catalog.
The Rule
A merchant (or sub-merchant) can only vend products that have been explicitly activated under their merchant account.
- Activation is performed by Pagamio during onboarding or by your account manager on request.
- Sub-merchants inherit the active product list from their parent merchant.
- The set of active products may change over time. Always treat the catalog endpoints as the source of truth.
How To See What's Available
Use the merchant-scoped product endpoints to discover the products you can sell. The endpoint depends on your account type:
| Account Type | Endpoint |
|---|---|
| Merchant | GET /merchants/{merchantId}/products |
| Sub-Merchant | GET /sub-merchants/{subMerchantId}/products |
The {merchantId} (or {subMerchantId}) is your own account's ID — you can only query products that belong to your own account. You can find your ID in the Pagamio merchant dashboard under My User → Merchants.
For product categories and field metadata (which are global), use:
GET /products/categories— list of categories.GET /products/categories/{categoryId}/fields— input/receipt field metadata for a category.
If a product does not appear in your scoped products response, you cannot purchase it.
What Happens If You Try To Vend An Inactive Product
The /purchase endpoint will reject the request with the following error:
{
"responseCode": "1009",
"responseMessage": "This product is not available for your account"
}
| Field | Value |
|---|---|
rejectionCode | 1009 |
rejectionReason | This product is not available for your account |
To resolve:
- Confirm the product code is correct (see Product Code Format).
- Re-fetch the catalog to confirm the product is currently active for your account.
- If you believe the product should be active, contact your Pagamio account manager to request activation.
Why This Restriction Exists
Product availability is controlled per merchant for several reasons:
- Commercial agreements differ between merchants (pricing, commissions, providers).
Last updated: April 2026