Products

Products are at the centre of the Octopus Cards platform. Each product represents a digital gift card, gaming top-up, or mobile recharge that can be ordered and delivered instantly.

Product Structure

Every product has a fixed country and currency. Within a product, one or more denominations are available — either a fixed face value (e.g. $50 Steam card) or a range (e.g. $10–$500 Amazon card).

Product: Steam Wallet Card (US)
├── Country:  United States (US)
├── Currency: USD
├── Category: Gaming
├── Delivery: Code with PIN — Instant
└── Denominations:
    ├── $10.00  (fixed)  — discount: 3.0%
    ├── $25.00  (fixed)  — discount: 3.0%
    ├── $50.00  (fixed)  — discount: 3.5%
    └── $100.00 (fixed)  — discount: 3.5%

Denominations

Each denomination defines a value range and a discount:

• Fixed denominations: min_value equals max_value (e.g. a $50 card)
• Range denominations: min_value < max_value (e.g. $10–$500, you choose the exact amount)

Pricing & Discounts

The discount you see on a product is the best available rate for your client account. Discounts come from two sources:

1. Default discount — the standard discount for the product
2. Client-specific discount — a custom rate negotiated for your account (overrides the default when higher)

The actual cost of an order is calculated by the Charges API, which factors in quantity, discounts, and any FX conversion.

Product Visibility

Not all products in the catalog are visible to every client:

• Products can be blacklisted per client (hidden from your catalog)
• Only active products with available inventory are returned

Delivery

Endpoints