Snowdrop MRS API
Snowdrop HomeTry our demo
  • Snowdrop Enrichment MRS
  • OpenAPI Docs
    • Enrich one transaction - GET
    • Enrich multiple transactions - POST
  • Implementation Guides
    • Quick Start
    • Data. How to get the best results
    • Examples
    • Recommended UX
    • Additional UX Considerations
  • Basic Concepts
    • List request
    • Restrictive vs Extended
    • Merchant Category Codes
  • Advanced Use Cases
    • Categorization
      • Categorization Overview
      • Transaction Category
      • Category Icons
    • Crowdsourcing
      • Overview
      • Crowdsourcing Example
    • Payment Intermediaries
      • Payment Intermediaries Example
    • Clear Response Enrichment
    • Google Maps
      • About Google Maps IDs
  • Legal & Compliance
    • Security / Compliance FAQ
      • Data Encryption
      • Penetration Testing
    • Terms of Service
      • MRS Terms of Service
      • Google Maps Terms of Service
  • Troubleshooting
  • FAQ
Powered by GitBook
On this page

Was this helpful?

  1. Implementation Guides

Quick Start

We recommend you read the full guides below. But if you prefer, you can just skip to the OpenAPI Docs for the technical specification.

Snowdrop Solutions' Merchant Reconciliation System (MRS) is a REST API that is simple and easy to implement. To make your first API request, you can use the OpenAPI documentation, or you can make a request in the language of your choice, below.

Note: You will need a valid API Key and know your Regional Domain to make an MRS request. Please contact us if you do not have these. (See FAQ).

To start, we will call the simple /api/v3/merchantendpoint, using a GET request.

curl --request GET --url 'https://regional-snowdrop-domain-goes-here.com/api/v3/merchant?merchant_name=mcdonalds&type=restrictive&location=london&country=GBR' --header 'X-Api-Key: <YOUR-API-KEY>'

import http.client

conn = http.client.HTTPSConnection("regional-snowdrop-domain-goes-here.com")

payload = ""

headers = { 'X-Api-Key': "<YOUR-API-KEY>" }

conn.request("GET", "/api/v3/merchant?merchant_name=mcdonalds&type=restrictive&location=london&country=GBR", payload, headers)

res = conn.getresponse() data = res.read()

print(data.decode("utf-8"))

var client = new RestClient("https://regional-snowdrop-domain-goes-here.com/api/v3/merchant?merchant_name=mcdonalds&type=restrictive&location=london&country=GBR");

var request = new RestRequest(Method.GET);

request.AddHeader("X-Api-Key", "<YOUR-API-KEY>");

IRestResponse response = client.Execute(request);

const data = null;

const xhr = new XMLHttpRequest();

xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {

if (this.readyState === this.DONE) {

console.log(this.responseText);

}

});

xhr.open("GET", "https://regional-snowdrop-domain-goes-here.com/api/v3/merchant?merchant_name=mcdonalds&type=restrictive&location=london&country=GBR");

xhr.setRequestHeader("X-Api-Key", "<YOUR-API-KEY>");

xhr.send(data);

HttpResponse response = Unirest.get("https://regional-snowdrop-domain-goes-here.com/api/v3/merchant?merchant_name=mcdonalds&type=restrictive&location=london&country=GBR") .header("X-Api-Key", "<YOUR-API-KEY>") .asString();

Note: the type=restrictive part refers to the type of request. You don't have to worry about this for now, we will cover restrictive vs extended later.

The returned response contains the enriched transaction in JSON format:

[
	{
		"name": "McDonald's",
		"website": "https://www.mcdonalds.com",
		"address": "",
		"img": "https://storage.googleapis.com/production-mrs-tm-logos/6273ea24bb09494554c95b90_2x.png",
		"logoImg": "https://storage.googleapis.com/production-mrs-tm-logos/6273ea24bb09494554c95b90_2x.png",
		"categoryImg": "https://storage.googleapis.com/production-mrs-category-logos/default/food_2x.png",
		"logoScore": 1,
		"category": "Eating out",
		"categories": [
			"restaurant"
		],
		"isClearResponse": false
	}
]

For more on the meaning of these fields, consult the OpenAPI Docs.

Having problems? Consult Troubleshooting or FAQ.

PreviousImplementation GuidesNextData. How to get the best results

Last updated 10 months ago

Was this helpful?