Integration
Finicity transaction cleanup
TxnKit helps Finicity cleanup workflows return cleaner merchant display metadata after the transaction feed is already available.
Target intent
clean Finicity-fed transaction rows after aggregation.
TxnKit sits after transaction data access.
Raw descriptor
POS PURCHASE MAIN ST CAFEAPI-shaped output
{
"normalized_merchant": null,
"display_name": null,
"category": null,
"subcategory": null,
"website": null,
"logos": {
"preferred": null,
"variants": [],
"warnings": [
"no_verified_logo_for_low_confidence_descriptor"
]
},
"confidence": 0.25,
"recurring_hint": false,
"processor_hint": "unknown",
"location_hint": null,
"signals": [
"generic_card_descriptor"
],
"warnings": [
"weak_merchant_evidence"
]
}Low-confidence results should keep fallback labels and warnings visible instead of forcing a guessed logo or website.
When to use
- You already receive transactions through Finicity cleanup and need cleaner UI rows.
- You want a one-descriptor enrichment API with bounded response fields.
- You need fallback warnings for ambiguous descriptors instead of silent overconfidence.
When not to use
- TxnKit sits after transaction data access.
- 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.