RocketKOR

COMING SOON

Retrieve a Merchant

Retrieve details for a merchant, such as the merchant’s locations, hours, and contact information.

To retrieve details for merchant, you will need:

  • Card BIN
  • Merchant ID

Endpoint

GET /v1/integrated-cards/card-bins/{binNumber}/merchants/{merchantId}

Authorization Header

Authorization: Bearer <access_token>

Path Parameters

binNumber  REQUIRED

string

Card Bank Identification Number (BIN).

merchantId  REQUIRED

string, max length: 30

ID of the merchant.

Request Body

None

Returns

Returns the Merchant Detail object.

SAMPLE RESPONSE

				
					{
  "merchantId": "1234567890",
  "merchantName": "XYZ Corporation",
  "merchantAddress": {
    "type": "WORKPLACE",
    "addressLine1": "1 Main St",
    "addressLine2": "Suite 201",
    "addressLine3": "",
    "addressLine4": "", 
    "addressLine5": "", 
    "cityName": "Greenville",
    "stateCode": "MO",
    "countryCode": "USA",
    "zipCode": "63944"
  },
  "merchantPhone": "555-555-5555",
  "merchantFax": "555-555-1234",
  "merchantLogoUrl": "www.xyz.com/logo",
  "merchantDescription": "Hardware store",
  "merchantReviews": {
    "google": "www.google.com/xyz-corporation",
    "yelp": "www.yelp.com/xyz-corporation"
  },
  "merchantKeywords": [
    "hardware",
    "building supplies"
  ],
  "merchantCategory": "string",
  "merchantSubCategory": "string",
  "merchantLongitude": 0,
  "merchantLatitude": 0,
  "webUrl": "www.xyz-corporation.com",
  "merchandiseDescription": "Hardware and building supplies",
  "merchandisePriceRange": "under 2000",
  "merchantWorkSchedule": {
    "Monday": {
      "open": "9:00",
      "close": "17:00"
    },
    "Tuesday": {
      "open": "9:00",
      "close": "17:00"
    },
    "Wednesday": {
      "open": "9:00",
      "close": "17:00"
    },
    "Thursday": {
      "open": "9:00",
      "close": "17:00"
    },
    "Friday": {
      "open": "9:00",
      "close": "17:00"
    },
    "Saturday": {
      "open": "9:00",
      "close": "21:00"
    },
    "Sunday": {
      "open": "9:00",
      "close": "15:00"
    }
  }
}