BlinkCodes 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."
    }
  }
}