List Merchant Category Restrictions
curl --request GET \
--url https://api.fyatu.com/api/v3/cards/merchant-category-restrictions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fyatu.com/api/v3/cards/merchant-category-restrictions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fyatu.com/api/v3/cards/merchant-category-restrictions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fyatu.com/api/v3/cards/merchant-category-restrictions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fyatu.com/api/v3/cards/merchant-category-restrictions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fyatu.com/api/v3/cards/merchant-category-restrictions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fyatu.com/api/v3/cards/merchant-category-restrictions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"status": 200,
"message": "Merchant category restrictions retrieved",
"data": {
"categories": [
{
"mcc": "5816",
"category": "Digital goods — games"
}
],
"count": 159,
"bins": [
{
"bin": "537100",
"network": "MASTERCARD",
"product": "Mastercard Elite"
}
],
"note": "<string>"
}
}Cards
List Merchant Category Restrictions
The merchant categories the card issuer has been observed declining, as MCC plus description, so you can answer a cardholder instead of guessing. GET /cards/merchant-category-restrictions.
GET
/
cards
/
merchant-category-restrictions
List Merchant Category Restrictions
curl --request GET \
--url https://api.fyatu.com/api/v3/cards/merchant-category-restrictions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.fyatu.com/api/v3/cards/merchant-category-restrictions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.fyatu.com/api/v3/cards/merchant-category-restrictions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fyatu.com/api/v3/cards/merchant-category-restrictions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fyatu.com/api/v3/cards/merchant-category-restrictions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fyatu.com/api/v3/cards/merchant-category-restrictions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fyatu.com/api/v3/cards/merchant-category-restrictions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"status": 200,
"message": "Merchant category restrictions retrieved",
"data": {
"categories": [
{
"mcc": "5816",
"category": "Digital goods — games"
}
],
"count": 159,
"bins": [
{
"bin": "537100",
"network": "MASTERCARD",
"product": "Mastercard Elite"
}
],
"note": "<string>"
}
}Overview
Some payments on this card programme are declined with a merchant-restriction reason, and until now the only way to find out was for a cardholder to try one. This endpoint returns the merchant categories in which we have observed those declines — the MCC and a plain-language description — so you can answer a support question with something better than a guess. It covers the two BINs issued on this programme —537100 (Mastercard Elite) and 486555 (VISA
Classic).
A listed category is not a blocked category. The restriction is applied per merchant, not per
category, so most categories on this list still approve most of their payments: in the measurement
behind it, MCC
5816 carried 620 declines alongside hundreds of approvals, and 7311 carried 150
declines against 1,852 approvals. Reading this list as “these categories will fail” will have you
tell a cardholder something false. Read it as “declines have been seen here” — the right next step
is almost always a retry or a different merchant in the same category.What this list is, and is not
| It is | It is not |
|---|---|
| Observed from authorisations that were actually declined | A list published by the card issuer — we have never been given one |
| The categories affected | The merchants affected. Those are deliberately not returned |
| Scoped to the two BINs on this programme | A statement about any other card you hold |
| Read-only reporting | A control. Nothing here is used to decide an authorisation |
Ordering and change detection
Entries are ordered by MCC, and that order is stable. A category leaves the list once the merchants in it have started succeeding again and stayed quiet, so diffing two fetches shows you real movement rather than a reshuffle — which is what makes it worth caching and re-fetching on a schedule rather than per request.Example Usage
<?php
$url = 'https://api.fyatu.com/api/v3/cards/merchant-category-restrictions';
$response = file_get_contents($url, false, stream_context_create([
'http' => [
'method' => 'GET',
'header' => 'Authorization: Bearer ' . $accessToken,
],
]));
$result = json_decode($response, true);
foreach ($result['data']['categories'] as $c) {
printf("%-6s %s\n", $c['mcc'], $c['category']);
}
// Check one category before telling a cardholder anything
const res = await fetch(
'https://api.fyatu.com/api/v3/cards/merchant-category-restrictions',
{ headers: { Authorization: `Bearer ${accessToken}` } }
);
const { data } = await res.json();
const affected = new Set(data.categories.map((c) => c.mcc));
if (affected.has(declinedTransaction.mcc)) {
// Declines have been seen in this category — but it is not blocked.
console.log('Known category. Suggest a retry or another merchant in the same category.');
}
import requests
r = requests.get(
"https://api.fyatu.com/api/v3/cards/merchant-category-restrictions",
headers={"Authorization": f"Bearer {access_token}"},
timeout=30,
)
data = r.json()["data"]
print(f"{data['count']} categories affected")
for c in data["categories"]:
print(c["mcc"], c["category"])
curl -s 'https://api.fyatu.com/api/v3/cards/merchant-category-restrictions' \
-H "Authorization: Bearer $ACCESS_TOKEN"
Example Response
{
"success": true,
"status": 200,
"message": "Merchant category restrictions retrieved",
"data": {
"categories": [
{
"mcc": "0742",
"category": "Veterinary services"
},
{
"mcc": "4121",
"category": "Taxis and ride-hailing"
},
{
"mcc": "5411",
"category": "Grocery stores and supermarkets"
},
{
"mcc": "5816",
"category": "Digital goods — games"
},
{
"mcc": "7311",
"category": "Advertising services"
}
],
"count": 159,
"bins": [
{
"bin": "537100",
"network": "MASTERCARD",
"product": "Mastercard Elite"
},
{
"bin": "486555",
"network": "VISA",
"product": "VISA Classic"
}
],
"note": "Merchant categories in which authorisations have been observed declined as restricted. Observed by us, not a list published by the card issuer. The restriction is applied per merchant rather than per category, so most of these categories still approve most payments — a listed category is a reason to expect some declines, not a block. Nothing here is used to decide an authorisation."
},
"meta": {
"requestId": "req_8f3c1d92b47a4e05",
"timestamp": "2026-11-02T11:42:07+02:00"
}
}
A
503 with code RESTRICTION_LIST_UNAVAILABLE means the list is not configured on the
environment you are calling. It is returned deliberately in place of an empty array, because an
empty array reads as “nothing is restricted”.Keeping it current
The list updates continuously from live authorisation outcomes and is reconciled hourly, which is when a category whose merchants have started working again drops off. A merchant has to stay quiet for several hours after a successful payment before it counts as recovered, so a category does not appear and disappear while merchants inside it are behaving inconsistently. Related: Card Transactions for what a specific decline said, andcard.transaction.declined to be told about declines as they happen.
