COMING SOON
Retrieve a list of merchants for a card Bank Identification Number (BIN). The BIN is the first 4–6 digits of the card number and represents the financial institution for the card. You can filter the results by the Card Program ID, the merchant category and subcategory, and the merchant address.
To retrieve a list of merchants, you will need:
GET /v1/integrated-cards/card-bins/{binNumber}/merchants
Authorization: Bearer <access_token>
binNumber REQUIRED
string
Card Bank Identification Number (BIN).
cardProgramID
string
This filter will return merchants belonging to a specific Card Program ID.
merchantCategory
string
This filter will return merchants belonging to a specific merchant category.
merchantSubCategory
string
This filter will return merchants belonging to a specific merchant subcategory.
merchantAddress1
string
Merchant’s address line 1. This filter will return merchants with this address.
merchantAddress2
string
Merchant’s address line 2. This filter will return merchants with this address.
merchantCity
string
Merchant’s city. This filter will return merchants with this address.
merchantStateCode
string
Merchant’s state, province, or territory. Must be an ISO 3166-2 uppercase alpha 2-character or 3-character country subdivision code. For example, Missouri is MO. This filter will return merchants with this address.
merchantPostalCode
string
Merchant’s postal code. This filter will return merchants with this address.
merchantCountry
string
Merchant’s country. This filter will return merchants with this address.
None
Returns an array of Merchant objects.
SAMPLE RESPONSE
[
{
"merchantId": "1234567890",
"merchantName": "XYZ Corporation",
"merchantAddress": {
"type": "WORKPLACE",
"addressLine1": "1 Main St",
"addressLine2": "Suite 201",
"addressLine3": "Side door",
"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"
]
},
{...},
{...}
]
© 2022 Rocket Financial. All rights reserved. RocketFNCL, RocketKOR, RocketBNK are trade names of Rocket Financial Inc.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL
© 2023 by Rocket Financial Inc. All rights reserved.