Solution
PayPal transaction descriptor cleanup
TxnKit helps teams solve PayPal descriptor cleanup with one safe descriptor, confidence-aware output, and warnings when identity evidence is weak.
Target intent
clean PayPal-wrapped merchant rows.
TxnKit does not inspect PayPal accounts or payment history.
Raw descriptor
PAYPAL *ACME-SUPPLYAPI-shaped output
{
"input": {
"descriptor": "PAYPAL *ACME-SUPPLY",
"country": "CA"
},
"output": {
"merchant_name": "Acme Supply",
"category": "Business supplies",
"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 need PayPal descriptor cleanup 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 does not inspect PayPal accounts or payment history.
- 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.