Cheque V2

Endpoint Overview

POST /api/v1/ocr/cheque-v2

Description

The Cheque OCR V2 API extracts key information from cheque images using advanced optical character recognition technology. This endpoint processes uploaded cheque images and returns structured data including account numbers, IFSC codes, amounts, and other critical information printed on the cheque.

Key Benefits

Automated extraction of cheque details eliminates manual data entry errors

Supports multiple input formats (direct upload, base64, or URL)

Extracts MICR code with high accuracy for reliable bank processing

Reduces processing time from minutes to seconds

Use Cases

Banking

Finance

Enterprise

Streamline cheque deposit processing at banks and financial institutions

Automate reconciliation of cheque payments in banking systems

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication (JWT format)
Content-Type	Yes	`multipart/form-data` for file uploads or `application/json` for base64/URL

Request Body

The API supports three different methods to submit a cheque image:

Method 1: Direct File Upload

Parameter	Type	Required	Description
file	File	Yes	The cheque image file to be processed
micr	Boolean	No	Whether to extract MICR code (default: `true`)
use_pdf	Boolean	No	Set to `true` if the uploaded file is a PDF

Method 2: Base64 Encoded Image

Parameter	Type	Required	Description
base_64	String	Yes	Cheque image encoded in Base64 format
micr	Boolean	No	Whether to extract MICR code (default: `true`)
use_pdf	Boolean	No	Set to `true` if the encoded file is a PDF

Method 3: Image URL/Link

Parameter	Type	Required	Description
link	String	Yes	URL pointing to the cheque image
micr	Boolean	No	Whether to extract MICR code (default: `true`)
use_pdf	Boolean	No	Set to `true` if the linked file is a PDF

Example Request (JSON for URL method)

{
  "link": "https://example.com/path/to/cheque-image.jpg",
  "micr": true
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the extracted cheque information
data.client_id	String	Unique identifier for the API request
data.account_number	String	Account number retrieved from the cheque
data.ifsc_code	String	IFSC code of the bank branch associated with the cheque
data.amount	String	Amount mentioned on the cheque
data.bank_name	String	Name of the bank issuing the cheque
data.date_of_cheque_issued	String	Date the cheque was issued (YYYY-MM-DD format)
data.receiver_name	String	Name of the receiver mentioned on the cheque
data.micr_code	String	MICR code as extracted from the cheque
status_code	Integer	HTTP status code indicating the result of the request
success	Boolean	Indicates whether the request was successful
message	String	Human-readable description of the result
message_code	String	Machine-readable code for the result

Example Successful Response

{
    "data": {
        "client_id": "ocr_cheque_v2_jRlmjcDAmutYqbSYioed",
        "account_number": "151201234",
        "ifsc_code": "SBIN0005566",
        "amount": "6000",
        "bank_name": "State Bank of India",
        "date_of_cheque_issued": "2018-02-11",
        "receiver_name": "MANISH KUMAR",
        "micr_code": "029876 412342015⑆ 016991⑈ 11"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Authentication Error

Invalid Image

Invalid File Format

Server Error

{
    "error": null,
    "message": "Your token is invalid. Please ensure that correct token is being used.",
    "status_code": 401,
    "success": false,
    "message_code": "invalid_token"
}

Occurs when the JWT token is missing, invalid, or expired.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption in transit

Implement token refresh mechanisms to handle token expiration gracefully

User Experience Guidelines

Provide clear feedback to users when their cheque is being processed

Implement image quality validation before submission to improve success rates

Allow users to verify extracted information and make corrections if needed

Consider implementing a retry mechanism for failed extractions

Code Samples

cURL

Python

Node.js

Related APIs

OCR PAN Card API: Extracts information from PAN card images

OCR Aadhaar Card API: Extracts information from Aadhaar card images

OCR Passport API: Extracts information from passport images

Bank Account Verification API: Verifies bank account details

Compliance and Legal Considerations

When processing cheque images, ensure you comply with relevant banking regulations and data protection laws. Cheque information contains sensitive financial data that must be handled securely. Ensure proper consent is obtained from users before processing their cheque images, and implement appropriate data retention and deletion policies.

{ "data": { "client_id": "ocr_cheque_v2_jRlmjcDAmutYqbSYioed", "account_number": "151201234", "ifsc_code": "SBIN0005566", "amount": "6000", "bank_name": "State Bank of India", "date_of_cheque_issued": "2018-02-11", "receiver_name": "MANISH KUMAR", "micr_code": "029876 412342015⑆ 016991⑈ 11" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Cheque V2

Cheque V2#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Method 1: Direct File Upload#

Method 2: Base64 Encoded Image#

Method 3: Image URL/Link#

Example Request (JSON for URL method)#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Cheque V2

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Method 1: Direct File Upload

Method 2: Base64 Encoded Image

Method 3: Image URL/Link

Example Request (JSON for URL method)

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples