GSTIN to MCC Mapping

8 min

Introduction

This API allows merchants to map their GST number to a specific Merchant Category Code (MCC) that is used by card networks to categorize businesses.This information can be useful for merchants who want to ensure that their business is categorized correctly for payment processing purposes.

How to call the API

You must first login before sending the request. The authorization header in the request must include the access token obtained from the login API call.

API Input Guidelines

Provide unique 15-digit alphanumeric GSTIN issued by the Goods and Services Tax Department

Sample Curl

Production

Preproduction

curl --location --request POST 'https://api.signzy.app/api/v3/merchant-underwriting/gst-to-mcc-mapping' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gstin": "<GST Number>"
}'

curl --location --request POST 'https://api-preproduction.signzy.app/api/v3/merchant-underwriting/gst-to-mcc-mapping' \
--header 'Content-Type: application/json' \
--header 'Authorization: <token>' \
--data-raw '{
    "gstin":"27AOKPP9482P1ZQ"
}'

Production

Preproduction

curl --location --request POST 'https://api.signzy.app/api/v3/merchant-underwriting/gst-to-mcc-mapping' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gstin": "<GST Number>"
}'

curl --location --request POST 'https://api-preproduction.signzy.app/api/v3/merchant-underwriting/gst-to-mcc-mapping' \
--header 'Content-Type: application/json' \
--header 'Authorization: <token>' \
--data-raw '{
    "gstin":"27AOKPP9482P1ZQ"
}'

Input Parameters

PARAMETER NAME	Required/Optional	DESCRIPTION
Authorization	Required	Unique to each consumer
Content-Type	Required	application/json
gstin	Required	GSTIN number to be searched

Sample Response

{
    "gstin": "27AOKPP9482P1ZQ",
    "mccCodesFound": true,
    "mccCodesList": [
        {
            "MccCode": "5963",
            "MccDescription": "DOOR-TO-DOOR SALES OR DIRECT SELLING ESTABLISHMENTS",
            "confidenceScore": ""
        }
    ]
}

Response Parameter

Parameter Name	Description	Data Type
gstin	A unique 15-digit alphanumeric GSTIN issued by the Goods and Services Tax Department provided in the input	String
mccCodesFound	This boolean parameter returns true or false, if a MCC code was found for the given gst from our system	Boolean
mccCodesList	Array of Objects containing MCC Data Array of Objects contain MCC Data Array of Objects contain MCC Data	Array <Objects>
mccCodesList[n].MccCode	Merchant Category Code	String
mccCodesList[n].MccDescription	Merchant Category Description	String
mccCodesList[n].confidenceScore	The Confidence score depicting the accuracy of our systems prediction on MCC Codes	String

HTTP Response Codes

Status Code	Description
200	All response details are valid
40x	not found, bad request, conflict

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected].