Catalog offers

GET /b2b/catalog/offers returns only offers that are active and priced for your tenant. Treat this response as the source of truth for what you can show and buy.

curl "$REWARDOS_API_BASE/b2b/catalog/offers" \
  -H "x-api-key: $REWARDOS_API_KEY"

{
  "offers": [
    {
      "offerId": "6af64816-a9ff-46d3-a211-5919422a19ca",
      "productId": "76e29940-8343-484e-a57e-205ed8932828",
      "productName": "Example product",
      "variantId": "0bcd7cf4-8746-43b9-a30c-0ad66c287f44",
      "variantSku": "example-sku",
      "variantName": "Example variant",
      "vendorCode": "vendor-code",
      "vendorKind": "portal",
      "fixedUnitPriceMinor": 95000,
      "currency": "INR"
    }
  ]
}

Choosing a face amount

Use the effective denomination fields returned for that offer:

• denominationType: "fixed" — choose one value from denominations.
• denominationType: "range" — choose a value from minVoucherAmount through maxVoucherAmount.
• Portal offers — send the fixedUnitPriceMinor converted to major currency units as faceAmount; quantity is always 1.

The service validates these rules when a purchase is created. Refresh the catalog after a validation_error; do not rely on a cached price or denomination.

Catalog fields may include images and effective redemptionInstructions. The instructions source is identified by redemptionInstructionsSource when present.