How It Works

While our core Data Enrichment Engine provides robust merchant identification, categorisation, and geolocation using our advanced models, this API performs an additional fast, live lookup to Premium Google Places endpoints. This process retrieves the very latest merchant details, providing a dynamic layer of information on top of our statically enriched data. This is ideal for user-facing applications where displaying the most current information, such as business opening hours or contact details, can significantly improve the customer experience.

📘

Important: The data retrieved from Google Services is for real-time display purposes only. To comply with Google’s terms of use this data must not be stored or cached in your systems.

Why use Moneyhub rather than going to Google directly?

Moneyhub will handle interfacing with Google directly, saving development effort and resource, whilst keeping enrichment needs to a single provider. Having Moneyhub handle this on your behalf also mitigates compliance risk of data being incorrectly stored or cached, thereby breaching Google's terms of use.

Retrieving enhanced data

Endpoint

This premium endpoint enriches a transaction by combining our own powerful, proprietary data with up-to-date merchant details fetched in real-time from Google.

[https://caas.moneyhub.co.uk/users/{userId}/accounts/{accountId}/transactions/{transactionId}/enhanced](/reference/get_users-userid-accounts-accountid-transactions-transactionid-enhanced)

This endpoint has a includeFieldTiers query parameter which can be used to control which fields are requested from Google.

💰

The cost of each call depends on which tiers are selected.

For example, if the search_pro value was included in includeFieldTiers then we would request all fields under the Text Search Pro SKU tier.

Please see the Google Places Text search API docs for an exact breakdown of which fields are returned for each tier.

Below is a mapping of the includeFieldTiers enum to tiers on the Google API.

Fields

Please see the Google Places Text search API docs for a list of possible fields that can be used to enhance transaction location and merchant data further.

Retrieving static map

Endpoint

This endpoint provides a URL for a static map image corresponding to a specific transaction's location. This allows for easy and efficient embedding of location visuals within your frontend application.

https://caas.moneyhub.co.uk/users/{userId}/accounts/{accountId}/transactions/{transactionId}/map

The query parameters width and height can be specified to request an image with a desired size.

File type

This endpoint returns a URL pointing to an image in format PNG.

Error handling

If we receive errors from the Google API the endpoints above will return a code 500 with a response detailing the source of the error and what the error was. Please refer to the API reference for more details on structure of the error response.