Merchant enrichment

Turn raw Fonepay terminal PANs and merchant-name strings into clean merchant data — name, MCC, spend category, and city — so you can enrich your own transaction feed with the same data that powers Swippee’s parsing. Requires a Bearer key (FULL scope); bills 1 unit per call (batch up to 1000 lookups).

Resolve a batch

curl -X POST https://api.swippee.com/v1/merchants/resolve \
  -H "Authorization: Bearer $SWIPPEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "terminals": ["2222000000000000"], "names": ["Example Cafe"] }'

{
  "data": {
    "count": 2,
    "matched": 2,
    "results": [
      {
        "input": "2222000000000000",
        "type": "terminal",
        "matched": true,
        "merchant": "Example Cafe",
        "mcc": "5814",
        "category": "dining",
        "city": "Kathmandu",
        "terminal": "2222000000000000"
      }
    ]
  },
  "meta": { "source": "Swippee Enrich" }
}

Single terminal lookup

curl https://api.swippee.com/v1/merchants/2222000000000000 \
  -H "Authorization: Bearer $SWIPPEE_API_KEY"

Resolve from a QR poster

Upload a Fonepay merchant QR poster (PDF or image) and get the merchant back — no need to read the terminal off it yourself. We read the printed terminal and, for images, decode the QR. Accepts PDF, JPEG, or PNG (max 10 MB); bills 1 unit.

curl -X POST https://api.swippee.com/v1/merchants/qr \
  -H "Authorization: Bearer $SWIPPEE_API_KEY" \
  -F "file=@poster.pdf"

{
  "data": {
    "found": true,
    "method": "qr",
    "source": "image",
    "terminal": "2222000000000000",
    "resolution": {
      "matched": true,
      "merchant": "Example Cafe",
      "mcc": "5814",
      "category": "dining",
      "city": "Kathmandu",
      "terminal": "2222000000000000"
    }
  },
  "meta": { "source": "Swippee Enrich" }
}

Name input is matched against the directory after normalization — so “Example Sweets PLTD” and “Example Sweets P LTD” resolve to the same merchant. Unmatched inputs come back with matched: false and null fields.

Consents — share a report safely Swippee Data API

Get started

Core concepts

Guides

Merchant enrichment

Resolve a batch

Single terminal lookup

Resolve from a QR poster

​Resolve a batch

​Single terminal lookup

​Resolve from a QR poster

Resolve a batch

Single terminal lookup

Resolve from a QR poster