Get merchant category restrictions
curl --request GET \
--url https://sandbox-api.fyatu.com/api/v3.20/merchant-category-restrictions \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox-api.fyatu.com/api/v3.20/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://sandbox-api.fyatu.com/api/v3.20/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://sandbox-api.fyatu.com/api/v3.20/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://sandbox-api.fyatu.com/api/v3.20/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://sandbox-api.fyatu.com/api/v3.20/merchant-category-restrictions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox-api.fyatu.com/api/v3.20/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
Get Merchant Category Restrictions
The merchant categories the card issuer has been observed declining, as MCC plus description. GET /merchant-category-restrictions. Requires cards:read scope.
GET
/
merchant-category-restrictions
Get merchant category restrictions
curl --request GET \
--url https://sandbox-api.fyatu.com/api/v3.20/merchant-category-restrictions \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox-api.fyatu.com/api/v3.20/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://sandbox-api.fyatu.com/api/v3.20/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://sandbox-api.fyatu.com/api/v3.20/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://sandbox-api.fyatu.com/api/v3.20/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://sandbox-api.fyatu.com/api/v3.20/merchant-category-restrictions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://sandbox-api.fyatu.com/api/v3.20/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 are declined with a merchant-restriction reason that carries no list, no effective date and no reason code. 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 cardholder with something better than a guess. It covers the two BINs issued on this programme:537100 (Mastercard Elite) and 486555 (VISA
Classic).
This is not the same thing as Get Restricted Merchants.
That endpoint returns merchants restricted at the provider — a configuration, and every card
you issue is checked against it at authorization time. This one is an observation of declines
nobody configured and that nothing enforces. One is a rule; the other is a measurement.
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 authorizations 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 | Per program, or per currency |
| Read-only reporting | A control. Nothing here is used to decide an authorization |
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 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
curl -s 'https://api.fyatu.com/api/v3.20/merchant-category-restrictions' \
-H "X-API-Key: $FYATU_API_KEY"
const res = await fetch(
'https://api.fyatu.com/api/v3.20/merchant-category-restrictions',
{ headers: { 'X-API-Key': process.env.FYATU_API_KEY } }
);
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.20/merchant-category-restrictions",
headers={"X-API-Key": api_key},
timeout=30,
)
data = r.json()["data"]
print(f"{data['count']} categories affected")
for c in data["categories"]:
print(c["mcc"], c["category"])
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_c41b70ea9d6f4832",
"platform": "LIVE",
"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”.
