Brands
The brand
object provides detailed metadata about the overarching brand associated with the merchant. This data is useful for categorization, UI representation (e.g. showing brand logos), aggregation and understanding corporate relationships.
Response Object:

Field Overview
id
string
Unique identifier for the brand.
name
string
The official name of the brand (e.g., “Carrefour Express”).
img
string (URL)
Main image associated with the brand. Typically used for brand visualization (e.g., banners, highlights).
website
string (URL)
Official website of the brand.
esg
object
ESG (Environmental, Social, and Governance) data. Excluded from this section; refer to ESG Documentation for full details.
brandCategory
object
Hierarchical classification of the brand. Excluded from this section. See Categorization reference.
Virtual Brands:
The API supports virtual brands to allow temporary representation of merchants that are not yet linked to a recognized brand. The virtual brand response essentially returns the merchant information inside the brand information as a placeholder. The way you can identify a virtual brand is by the missing id field inside the brand response. Once the proper brand is assigned, the virtual placeholder will be replaced accordingly.
If an MCC is included in the request, the response will also contain detailed categorisation regardless of whether a brand is found or not based on our MCC mapping techniques.
Last updated
Was this helpful?