Solution

Card transaction descriptor parser

TxnKit helps teams solve card descriptor parsing with one safe descriptor, confidence-aware output, and warnings when identity evidence is weak.

Target intent

parse processor wrappers, locations, and noisy fragments from card rows.

TxnKit is not a statement ingestion or OCR system.

Raw descriptor

VISA DDA PUR 5542 GAS BAR

API-shaped output

{
  "normalized_merchant": "visa dda pur gas bar",
  "display_name": "Visa Dda Pur Gas Bar",
  "category": null,
  "subcategory": null,
  "website": null,
  "logos": {
    "preferred": null,
    "variants": [],
    "warnings": [
      "no_verified_logo_for_local_merchant"
    ]
  },
  "confidence": 0.56,
  "recurring_hint": false,
  "processor_hint": "unknown",
  "location_hint": null,
  "signals": [
    "removed_reference_tokens"
  ],
  "warnings": [
    "local_merchant_identity_not_verified"
  ]
}

Low-confidence results should keep fallback labels and warnings visible instead of forcing a guessed logo or website.

When to use

  • You need card descriptor parsing for transaction-feed UI, audit, or import review workflows.
  • You can send safe anonymized descriptors without customer PII or full statement text.
  • You want API-shaped output that a developer can inspect before wiring product UI.

When not to use

  • TxnKit is not a statement ingestion or OCR system.
  • Do not use TxnKit to process card numbers, account numbers, full statements, bank credentials, emails, phone numbers, addresses, customer names, or customer PII.
  • Do not use TxnKit when the product requirement is guaranteed merchant identity, every-merchant resolution, or contracted uptime terms.

Proof surfaces

The public contract is POST /v1/enrich, backed by the OpenAPI file, benchmark examples, privacy rules, and deterministic request-path tests.

OpenAPI · Benchmark · Security · Pricing

Related pages