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. To make your first call, you can use the OpenAPI documentation, or you can make a basic 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.

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

cURL

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>'

Python

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"))

C#

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);

Javascript

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);

Java

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();

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.