Merchant Risk Underwriting

GSTIN to MCC

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
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.signzy.app/api/v3/merchant-underwriting/gst-to-mcc-mapping' \
--header 'Authorization: <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gstin": "<GST Number>"
}'
﻿
Curl
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"
}'
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
JSON
{
    "gstin": "27AOKPP9482P1ZQ",
    "mccCodesFound": true,
    "mccCodesList": [
        {
            "MccCode": "5963",
            "MccDescription": "DOOR-TO-DOOR SALES OR DIRECT SELLING ESTABLISHMENTS",
            "confidenceScore": ""
        }
    ]
}
{
    "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
Note: Confidence Score is a roadmap item on which the team is currently working. 
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].
﻿

Fetch Merchant Report

Read Metadata

Docs powered by Archbee

TABLE OF CONTENTS

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

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

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