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 BARAPI-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.