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.

​

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.

​

Step 3: Process the Results

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

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'), None)
    if mcc_check_result:
        mcc_data = mcc_check_result['command_result']['output']['payload']
        mcc_code = mcc_data.get('mcc_code')
        mcc_description = mcc_data.get('mcc_code_description')
        print(f"MCC Code: {mcc_code}")
        print(f"Description: {mcc_description}")
    else:
        print("MCC code check result not found.")

​

Conclusion

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

1. It requires minimal input (basic business information).
2. It can be executed with a single API call to runCheck.
3. 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.