Identify Transaction
brandfetch.identify_transaction
ActionBusiness appsconnection required
Calls the Brandfetch API with the connection's credentials.
Turn a raw card-transaction description into the merchant's brand, with its domain, logo and colours.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Bearer token
- Providers
- Brandfetch
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- client_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
2 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
transaction_label The raw transaction text exactly as the payment processor wrote it. | string | Yes | — | — | STARBUCKS 1523 OMAHA NE |
country_code The ISO 3166-1 alpha-2 code of the country the transaction took place in. | string | Yes | — | 2–2 characters; matches ^[A-Za-z]{2}$ | US |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"country_code": "US",
"transaction_label": "STARBUCKS 1523 OMAHA NE"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id Brandfetch's unique id for the brand. | string | — |
name The brand's name, or null when Brandfetch has none. | string | — |
domain The brand's website domain. | string | — |
claimed True when the brand's owner has claimed the profile. | boolean | — |
description A short description of the brand. | string | — |
longDescription A longer description of the brand. | string | — |
links The brand's social profiles, each with a name and a url. | array | — |
logos Logos, symbols and icons, each with a theme and file formats. | array | — |
colors The brand palette, each entry with a hex, type and brightness. | array | — |
fonts The brand's fonts, each with a name, type, origin and weights. | array | — |
images Banner and other brand images, each with its file formats. | array | — |
company Firmographic data: employees, founded year, industries, location. | object | — |
qualityScore How confident Brandfetch is in this record, from 0 to 1. | number | — |
isNsfw True when the brand is flagged as not safe for work. | boolean | — |
urn The brand's uniform resource name. | string | — |
logo_url Derived: the primary logo's file URL, SVG when one exists. | string | — |
icon_url Derived: the icon's file URL, or null when the brand has none. | string | — |
accent_color Derived: the accent colour's hex code. | string | — |
title_font Derived: the name of the brand's title font. | string | — |
body_font Derived: the name of the brand's body font. | string | — |
{
"accent_color": "",
"body_font": "",
"claimed": false,
"colors": [],
"company": {},
"description": "",
"domain": "",
"fonts": [],
"icon_url": "",
"id": "",
"images": [],
"isNsfw": false,
"links": [],
"logo_url": "",
"logos": [],
"longDescription": "",
"name": "",
"qualityScore": 0,
"title_font": "",
"urn": ""
}Related Brandfetch nodes
See Identify Transaction run in a workflow.
In a technical demo we add the Brandfetch connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.