Operations related to products
Operations related to products.
Use GET /v1/products to browse the catalog. Key fields to check before ordering: availability (only ON_SALE products can be ordered), available_delivery_method (how the gift can reach the recipient — see Delivery methods), net_price (your account-specific price), and recipient_info_provided_by (whether the recipient enters their own delivery details).
Before placing time-sensitive orders, confirm live availability with GET /v1/products/{id}/availability.
Pricing and currency
net_price is the amount you pay. It reflects your account's discount policy and already includes transaction_fee_rate where a product carries one — never add that fee on top. A product carries either a supplier fee or a margin you share in, never both.
Prices are stated in the product's own currency. If your account balance is held in another currency, conversion happens when the order is created, at the rate in effect at that moment. There is no endpoint to look that rate up beforehand. The rate actually applied comes back with the order, per item, as price_charged.applied_exchange_rate.
Voucher validity
validity is the redemption window in days, and is null whenever the supplier publishes no validity period — common enough that you should always handle null.
One field covers two different kinds of product:
- A validity period returns a constant counted from issuance (for example
365). One year counts as 365 days, one month as 30. - A fixed expiry date returns the days remaining from today, so the value shrinks daily and reaches
0at expiry.
You cannot tell the two apart from this field alone, so do not persist it as an absolute expiry date at order time.