Location Matching and Verification

How It Works

Extraction:Address information is extracted from the receipt or invoice.
Geocoding: The address is converted into geographical coordinates.
Matching: The location is matched against a database of known merchant locations using vector-based cosine similarity and Levenshtein distance algorithms.
Verification: The matched location is verified for accuracy. An address match is confirmed only if the receipt's address is within 46 kilometres of an address entry on the list.

Set-Up

1. Contact Taggun

Reach out to [email protected] to enable this feature for your account.

This feature is available in all Verbose Data Extraction API Endpoints.

2. Implementation

To streamline this process, Taggun allows clients to set up merchant and location matching using a predefined list of known merchants and address details.

Prepare a CSV file with a list of merchants including names and addresses.
Import the CSV file to API Endpoint: /api/account/v1/known-merchants/import
Initiate the import process. Note: This may take over a minute depending on the list size.
Be aware that this import will replace any existing merchants set up for your account.
After import, export the list from API Endpoint: /api/account/v1/known-merchants/export
Verify the accuracy of the merchant data, especially geographical coordinates.
Regularly update the merchant list to reflect any changes.

JSON Response

Definitions

Field Name	Type	Access Path	Description
Is the Merchant Name Matched?	Boolean	`entities.normalisedMerchant.data.isMerchantNameMatched`	Indicates whether the merchant name (brand name) matches an entry on the predefined list. A true value confirms a match with the printed merchant name.
Is the Merchant Address Matched?	Boolean	`entities.normalisedMerchant.data.isMerchantAddressMatched`	Indicates whether the merchant address matches an entry on the list. A true value confirms the address on the receipt matches an entry on the list.
Merchant Name	String	`merchantName.data`	The normalised merchant name on the receipt

Example Response

{
  "merchantLocation": {
    "address": "123 High St, London NW1 7JR, UK",
    "latitude": 51.5259,
    "longitude": -0.1403,
    "verified": true,
    "confidenceLevel": 0.92
  },
  "entities": {
    "normalisedMerchant": {
      "data": {
        "isMerchantNameMatched": true,
        "isMerchantAddressMatched": true
      }
    }
  },
  "merchantName": {
    "data": "Normalised Merchant Name"
  }
}

Additional Data Points

entities.normalisedMerchant.data.isMerchantNameMatched: Indicates whether the merchant name matches an entry on the predefined list.
entities.normalisedMerchant.data.isMerchantAddressMatched: Indicates whether the merchant address matches with an entry on the list.
merchantName.data: Reflects the normalised merchant name corresponding to the list entry.

Use Cases

Shopping Mall Loyalty Programs: Ensures promotional rewards are exclusive to specific store locations within a mall and not applicable to other branches of the same brand in different locations.
Fraud Detection: Identifies unusual purchase locations.
Travel Expense Management: Accurately tracks and verifies expenses based on location.

Best Practices

Use the verified flag to determine the reliability of the location data.
Combine with Merchant Name Normalisation for the most accurate results.
Consider time zone information when processing transaction times.
Regularly update your merchant list to maintain accuracy.
Verify the accuracy of geographical coordinates in your merchant list.

Get Started

By leveraging Taggun's Location Matching and Verification, businesses can ensure precise validation of merchant locations, enhancing the accuracy of loyalty programs and fraud detection systems.

Reach out to us at [email protected] to get access to Taggun's Location Matching and Verification.