Integration

Plaid transaction cleanup

TxnKit helps Plaid cleanup workflows return cleaner merchant display metadata after the transaction feed is already available.

Target intent

clean merchant display after Plaid transaction ingestion.

TxnKit sits after Plaid; it does not replace Plaid.

Raw descriptor

SQ *JOES COFFEE 0421 TORONTO

API-shaped output

{
  "input": {
    "descriptor": "SQ *JOES COFFEE 0421 TORONTO",
    "country": "CA"
  },
  "output": {
    "merchant_name": "Joes Coffee",
    "category": "Coffee shop",
    "confidence": "medium",
    "signals": [
      "processor_pattern",
      "merchant_alias",
      "category_hint"
    ],
    "warnings": [
      "review_low_confidence_matches_before_showing_logo"
    ],
    "logos": []
  }
}

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 Plaid 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 Plaid; it does not replace Plaid.
  • 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