Guide

Merchant logo API for transaction feeds

Logo output should be confidence-aware metadata, not a guessed image URL bolted onto a merchant name.

Answer-first summary

TxnKit returns logo variants only when merchant identity evidence supports them. For weak matches, the response should omit logo assets and return warnings.

Raw descriptor example

POST /v1/enrich

{
  "raw_description": "STARBUCKS STORE 04821",
  "country": "US"
}

{
  "display_name": "Starbucks",
  "logos": {
    "preferred": {
      "format": "png",
      "width": 64,
      "height": 64,
      "theme": "any",
      "purpose": "transaction_feed_icon",
      "confidence": 0.96
    }
  }
}

When to use

Use reviewed logo variants when a product needs dark-mode-safe transaction icons, receipt-detail assets, search-result marks, or profile headers.

When not to use

Do not render logos for low-confidence descriptors, local merchants without verified assets, marketplace sellers without evidence, or unreviewed scraped candidates.