Merchant code categorization

Merchant Category Code (MCC) verification is another important aspect of KYB processes. This example demonstrates how to use the Parcha API to verify a business’s MCC code based on its basic information.

Step 1: Prepare Business Data and Run MCC Code Verification

Use the runCheck endpoint to initiate the MCC code verification process.

curl -X POST 'https://demo.parcha.ai/api/v1/runCheck' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
  "agent_key": "your-agent-key",
  "kyb_schema": {
    "id": "unique-case-id",
    "self_attested_data": {
      "business_name": "TechInnovate Solutions",
      "description": "Providing cutting-edge software solutions for businesses",
      "website": "https://techinnovatesolutions.com",
      "country_code": "US"
    }
  },
  "check_id": "kyb.mcc_code_check_v3",
  "webhook_url": "https://your-webhook-url.com/callback"
}'

import requests

api_key = 'YOUR_API_KEY'
url = 'https://demo.parcha.ai/api/v1/runCheck'

data = {
    "agent_key": "your-agent-key",
    "kyb_schema": {
        "id": "unique-case-id",
        "self_attested_data": {
            "business_name": "TechInnovate Solutions",
            "description": "Providing cutting-edge software solutions for businesses",
            "website": "https://techinnovatesolutions.com",
            "country_code": "US"
        }
    },
    "check_id": "kyb.mcc_code_check_v3",
    "webhook_url": "https://your-webhook-url.com/callback"
}

headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

import axios from 'axios';

const apiKey = 'YOUR_API_KEY';
const url = 'https://demo.parcha.ai/api/v1/runCheck';

const data = {
  agent_key: "your-agent-key",
  kyb_schema: {
    id: "unique-case-id",
    self_attested_data: {
      business_name: "TechInnovate Solutions",
      description: "Providing cutting-edge software solutions for businesses",
      website: "https://techinnovatesolutions.com",
      country_code: "US"
    }
  },
  check_id: "kyb.mcc_code_check",
  webhook_url: "https://your-webhook-url.com/callback"
};

axios.post(url, data, {
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  }
})
.then(response => console.log(response.data))
.catch(error => console.error('Error:', error));

Step 2: Poll for Job Status (Optional if using webhook)

If you’re not using a webhook, you can poll for the job status using the getJobById endpoint.

curl 'https://demo.parcha.ai/api/v1/getJobById?job_id=YOUR_JOB_ID&include_check_results=true' \
-H 'Authorization: Bearer YOUR_API_KEY'

import requests
import time

api_key = 'YOUR_API_KEY'
job_id = 'YOUR_JOB_ID'
url = f'https://demo.parcha.ai/api/v1/getJobById?job_id={job_id}&include_check_results=true'

headers = {
    'Authorization': f'Bearer {api_key}'
}

while True:
    response = requests.get(url, headers=headers)
    job_data = response.json()
    
    if job_data['status'] == 'complete':
        print("Job completed!")
        print(job_data)
        break
    else:
        print("Job still in progress. Waiting...")
        time.sleep(5)  # Wait for 5 seconds before checking again

import axios from 'axios';

const apiKey = 'YOUR_API_KEY';
const jobId = 'YOUR_JOB_ID';
const url = `https://demo.parcha.ai/api/v1/getJobById?job_id=${jobId}&include_check_results=true`;

function pollJobStatus() {
  axios.get(url, {
    headers: {
      'Authorization': `Bearer ${apiKey}`
    }
  })
  .then(response => {
    const jobData = response.data;
    if (jobData.status === 'complete') {
      console.log("Job completed!");
      console.log(jobData);
    } else {
      console.log("Job still in progress. Waiting...");
      setTimeout(pollJobStatus, 5000);  // Check again after 5 seconds
    }
  })
  .catch(error => console.error('Error:', error));
}

pollJobStatus();

Step 3: Process the Results

Once the job is completed, examine the results to retrieve the MCC code and its description.

Python

if job_data['status'] == 'complete':
    mcc_check_result = next(
        (result for result in job_data['check_results']
         if result['command_id'] == 'kyb.mcc_code_check_v3'),
        None
    )
    if mcc_check_result:
        payload = mcc_check_result['payload']
        mcc_code = payload.get('mcc_code')
        mcc_title = payload.get('mcc_title')
        mcc_description = payload.get('mcc_code_description')
        print(f"MCC Code: {mcc_code}")
        print(f"Title: {mcc_title}")
        print(f"Description: {mcc_description}")
    else:
        print("MCC code check result not found.")

Or use JSONPath for cleaner extraction:

Python

from urllib.parse import quote

jsonpath_query = '$.check_results[?(@.command_id=="kyb.mcc_code_check_v3")].payload'
url = f'https://demo.parcha.ai/api/v1/getJobById?job_id={job_id}&include_check_results=true&jsonpath_query={quote(jsonpath_query)}'

response = requests.get(url, headers=headers)
mcc_payload = response.json()[0]

print(f"MCC Code: {mcc_payload['mcc_code']}")
print(f"Title: {mcc_payload['mcc_title']}")
print(f"Description: {mcc_payload['mcc_code_description']}")

Conclusion

This MCC code verification process demonstrates a straightforward use of the Parcha API:

It requires minimal input (basic business information).
It can be executed with a single API call to runCheck.
Results can be retrieved either through a webhook or by polling the job status.

This approach is efficient for quick verifications that don’t require document uploads or complex multi-step processes. Always ensure that the business information provided is accurate to get the most reliable MCC code verification results.

Get Started

Concepts

Use Cases

Know Your Business (KYB)

Know Your Customer (KYC)

Step 1: Prepare Business Data and Run MCC Code Verification

Step 2: Poll for Job Status (Optional if using webhook)

Step 3: Process the Results

Conclusion

​Step 1: Prepare Business Data and Run MCC Code Verification

​Step 2: Poll for Job Status (Optional if using webhook)

​Step 3: Process the Results

​Conclusion

Step 1: Prepare Business Data and Run MCC Code Verification

Step 2: Poll for Job Status (Optional if using webhook)

Step 3: Process the Results

Conclusion