Browse the product catalog

List the products available to your dealer account, with your pricing. Use it to discover the productItem IDs you pass when creating an order.

Request

curl -H "x-api-key: sk_prod_your_key_here" \
  "https://api.palcards.ps/product/catalog?ps=20"

GET /product/catalog

Query parameters

Response

{
  "pageNumber": 1,
  "pageSize": 20,
  "total": 134,
  "nextPageCursor": "Cj0KFQ...",
  "data": [
    {
      "id": 101,
      "name": "Game Card X",
      "status": "active",
      "type": "chargingCard",
      "customerRequiredInfo": [],
      "productItems": [
        {
          "id": 5001,
          "name": "10 USD",
          "publicPrice": { "currency": "USD", "value": 10 },
          "appliedPrices": { "price": 9.5, "discount": 0.5, "discountPercent": 5 }
        }
      ]
    }
  ]
}

Fields

• data[].id — product ID. type is chargingCard (voucher) or topUp.
• productItems[].id — the productItem you buy; pass it to POST /order.
• publicPrice — list price; appliedPrices — your price after your dealer discount.
• customerRequiredInfo — extra fields the customer must provide for this product (e.g. accountId); you send them in the order's context.

Pagination

Pass the nextPageCursor from one response as the cursor of the next request, until nextPageCursor is no longer returned.