Tillo · Schema

Tillo Brand

Schema for a Tillo gift card brand

FinanceGift CardsPaymentsRewardsIncentives

Properties

Name Type Description
name string Brand display name
identifier string Unique brand slug
country string ISO 3166-1 alpha-2 country code
currency string ISO 4217 currency code
min_value number Minimum denomination
max_value number Maximum denomination
face_value array Fixed denominations
async_only boolean Requires async ordering
transaction_types array Supported transaction types
category string Brand category
logo_url string Brand logo URL
terms_and_conditions_copy string Brand T&C text
View JSON Schema on GitHub

JSON Schema

tillo-brand-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tillo/main/json-schema/tillo-brand-schema.json",
  "title": "Tillo Brand",
  "description": "Schema for a Tillo gift card brand",
  "type": "object",
  "properties": {
    "name": {"type": "string", "description": "Brand display name"},
    "identifier": {"type": "string", "description": "Unique brand slug"},
    "country": {"type": "string", "description": "ISO 3166-1 alpha-2 country code"},
    "currency": {"type": "string", "description": "ISO 4217 currency code"},
    "min_value": {"type": "number", "minimum": 0, "description": "Minimum denomination"},
    "max_value": {"type": "number", "minimum": 0, "description": "Maximum denomination"},
    "face_value": {"type": "array", "items": {"type": "number"}, "description": "Fixed denominations"},
    "async_only": {"type": "boolean", "description": "Requires async ordering"},
    "transaction_types": {
      "type": "array",
      "items": {"type": "string", "enum": ["issue", "balance_check", "top_up", "refund"]},
      "description": "Supported transaction types"
    },
    "category": {"type": "string", "description": "Brand category"},
    "logo_url": {"type": "string", "format": "uri", "description": "Brand logo URL"},
    "terms_and_conditions_copy": {"type": "string", "description": "Brand T&C text"}
  },
  "required": ["identifier", "name"]
}