KodShop catalog

{'type': 'object', 'properties': {'email': {'type': 'string', 'description': 'Delivery address. The code, eSIM profile or number is emailed here, and it is the only identity the order has. Required on the first call.'}, 'amount': {'type': 'number', 'description': 'Only for products where get_product reported requires_amount; send instead of item_id.'}, 'item_id': {'type': 'integer', 'description': 'Denomination id from get_product items[].'}, 'order_id': {'type': 'string', 'description': 'Second call only: the order_id returned by the first call.'}, 'quantity': {'type': 'integer', 'description': 'Copies to buy. Defaults to 1 — send it only to buy several.'}, 'product_id': {'type': 'integer', 'description': 'Product id from search_catalog.'}, 'product_type': {'enum': ['giftcard', 'topup'], 'type': 'string', 'description': 'giftcard = voucher, topup = service recharge. eSIM data plans from search_catalog are bought as giftcard too — the value names the order shape, not the goods.'}, 'account_number': {'type': 'string', 'description': 'Only for products where get_product reported requires_account: the recipient account the top-up credits.'}, 'payment_payload': {'type': 'object', 'description': 'Second call only: the signed x402 PaymentPayload built from the requirements the first call returned.'}}}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'description': 'Product id from search_catalog.'}}}

{'type': 'object', 'properties': {'type': {'enum': ['voucher', 'recharge_fixed', 'recharge', 'e_sim'], 'type': 'string', 'description': 'voucher = gift card, recharge_fixed / recharge = top-up, e_sim = eSIM data plan.'}, 'limit': {'type': 'integer', 'description': 'Max products to return (default 10, max 50).'}, 'query': {'type': 'string', 'description': 'Free text matched against product name and brand, e.g. "steam" or "playstation".'}, 'country': {'type': 'string', 'description': 'ISO-3166-1 alpha-2 country code the product is issued for, e.g. US, TR.'}}}