Skip to main content
Triqai enriches transactions with multiple entity types. Each entity represents a real-world business, place, or service that’s relevant to understanding the transaction.

​
Entity Types

Merchants

The business or company behind the transaction

Locations

The physical place where the transaction occurred

Payment Processors

Intermediary payment services like Stripe or PayPal

P2P Platforms

Peer-to-peer transfer services like Venmo or Zelle

​
Merchants

Merchants are the primary entities in most transactions. When identified, you get: 
{
  "merchant": {
    "status": "found",
    "confidence": 98,
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Starbucks",
      "alias": ["Starbucks Coffee", "SBUX"],
      "keywords": ["coffee", "cafe", "drinks"],
      "icon": "https://logos.triqai.com/images/starbuckscom",
      "description": "Multinational chain of coffeehouses",
      "color": "#00704A",
      "website": "https://www.starbucks.com",
      "domain": "starbucks.com"
    }
  }
}

​
Merchant Fields

FieldTypeDescription
idUUIDUnique identifier for the merchant
namestringCanonical merchant name
aliasstring[]Alternative names and abbreviations
keywordsstring[]Related search terms
iconURLLogo image URL
descriptionstringBrief description of the business
colorstringBrand color (hex format)
websiteURLOfficial website
domainstringPrimary domain name

​
Merchant Coverage

Triqai maintains a database of over 150 million companies worldwide, with:
  • 143,000+ logos for visual branding
  • Normalized names for consistent identification
  • Multiple aliases to match various transaction formats

​
Locations

Location enrichment provides geographic context for transactions: 
{
  "location": {
    "status": "found",
    "confidence": 92,
    "data": {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "name": "Starbucks - Times Square",
      "formatted": "1530 Broadway, New York, NY 10036, USA",
      "phoneNumber": "+1-212-555-0123",
      "structured": {
        "street": "1530 Broadway",
        "city": "New York",
        "state": "NY",
        "postalCode": "10036",
        "country": "US",
        "countryName": "United States",
        "coordinates": {
          "latitude": 40.7580,
          "longitude": -73.9855
        },
        "timezone": "America/New_York"
      }
    }
  }
}

​
Location Fields

FieldTypeDescription
idUUIDUnique identifier for the location
namestringLocation name (may include store number)
formattedstringFull formatted address
phoneNumberstringContact phone number (if available)
structured.streetstringStreet address
structured.citystringCity name
structured.statestringState/province/region
structured.postalCodestringPostal or ZIP code
structured.countrystringISO country code
structured.countryNamestringFull country name
structured.coordinatesobjectLatitude and longitude
structured.timezonestringIANA timezone identifier

​
Location Coverage

  • 10M+ places globally
  • 150+ countries supported
  • Store-level precision when available

​
Payment Processors

Payment processors are intermediary services that handle transactions on behalf of merchants: 
{
  "paymentProcessor": {
    "status": "found",
    "confidence": 99,
    "data": {
      "id": "770e8400-e29b-41d4-a716-446655440002",
      "name": "Stripe",
      "icon": "https://logos.triqai.com/images/stripecom",
      "color": "#635BFF",
      "website": "https://stripe.com"
    }
  }
}

​
Supported Processors

Triqai recognizes 4,000+ payment processors including:
  • Stripe - Online payment processing
  • PayPal - Digital payments and transfers
  • Square - POS and online payments
  • Adyen - Global payment platform
  • Braintree - Online and mobile payments
  • Worldpay - Payment processing
  • Klarna - Buy now, pay later
  • Afterpay - Deferred payments

​
Why It Matters

Payment processor detection is valuable for:
  • Identifying the actual merchant behind processor-branded transactions
  • Understanding payment methods used by customers
  • Fraud detection by recognizing unusual processor patterns
  • Analytics on payment method preferences

​
P2P Platforms

Peer-to-peer platforms facilitate transfers between individuals: 
{
  "peerToPeer": {
    "status": "found",
    "confidence": 95,
    "data": {
      "platform": {
        "id": "880e8400-e29b-41d4-a716-446655440003",
        "name": "Venmo",
        "icon": "https://logos.triqai.com/images/venmocom",
        "color": "#3D95CE",
        "website": "https://venmo.com"
      },
      "recipient": {
        "displayName": "John Doe",
        "username": null
      },
      "memo": "Dinner split"
    }
  }
}

​
P2P Fields

FieldTypeDescription
platformobjectThe P2P service details
recipient.displayNamestringRecipient’s name as shown in transaction
recipient.usernamestringPlatform username (if available)
memostringPayment note or description

​
Supported P2P Platforms

  • Venmo - Social payments
  • Zelle - Bank-to-bank transfers
  • Cash App - Mobile payments
  • PayPal - Personal payments
  • Apple Pay - Person-to-person payments
  • Google Pay - Send money
Privacy: Recipient names are stored per-organization and never shared globally. This ensures personal information remains private.

​
Entity Status

Each entity enrichment returns a status:
StatusMeaning
foundEntity was successfully identified
no_matchNo matching entity could be found
not_applicableThis entity type doesn’t apply (e.g., P2P for a Starbucks purchase)

​
Fetching Entity Details

You can fetch full entity details by ID: 
curl https://api.triqai.com/v1/merchants/{id} \
  -H "X-API-Key: YOUR_API_KEY"

​
Entity Sharing

Entities are shared resources:
  • Merchants, locations, payment processors, and P2P platforms are shared across all organizations
  • This ensures consistent identification and reduces duplication
  • Entity IDs are stable and can be used for deduplication
Exception: P2P recipient names are scoped to your organization for privacy.

​
Next Steps

Confidence Scores

Learn how to interpret confidence values

Entity APIs

Explore the entity lookup endpoints