Vietnam Passport OCR with the StructOCR Python SDK

Challenges with Vietnamese Passport Verification

Extracting accurate information from Vietnam passports presents unique challenges. The modern biometric e-passports (blue cover) feature advanced polycarbonate data pages with intricate background artwork showcasing national landmarks and traditional lotus motifs, which can interfere with text recognition. Furthermore, handling bilingual field descriptors and passenger names containing complex Vietnamese diacritics (tones and specialized characters like ă, đ, ê, ô, ơ, ư) requires highly specialized parsing logic. These factors can significantly hinder manual data entry and traditional OCR methods, making a specialized passport extraction api essential.

Why StructOCR for Vietnamese Passports

StructOCR offers unparalleled accuracy for Vietnam passport data extraction, thanks to our advanced machine learning models trained extensively on datasets featuring Vietnamese text structures and complex diacritics. Our solution is specifically engineered to overcome the common optical obstacles found in these travel documents. Whether you need a powerful passport extraction api or a comprehensive fintech identity verification software, StructOCR delivers robust performance. For the fastest Python integration, install the official StructOCR SDK and see the Python SDK documentation.

Built for High-Compliance Industries

• Travel & Aviation: Our technology serves as a critical verification solution for travel, enabling seamless integration with Vietnam's e-Visa system and automated border control gates. This speeds up passenger throughput at major international hubs like Noi Bai (HAN) and Tan Son Nhat (SGN).
• Financial Services: By integrating our sophisticated fintech identity verification software, financial institutions can automate their e-KYC onboarding workflows with confidence, ensuring compliance with strict State Bank of Vietnam (SBV) and Anti-Money Laundering (AML) regulations. This reduces manual review times and mitigates fraud risk.

Vietnam Passport OCR with the Python SDK

The official Python SDK handles file encoding, API communication, and structured passport results. Use the SDK directly or open the FastAPI tab for a server endpoint. Keep your API key in STRUCTOCR_API_KEY.

Prerequisite: `pip install structocr`; set the server-side `STRUCTOCR_API_KEY` environment variable.

Prefer another stack? Open the Node.js SDK + Express integration.

import os
from structocr import StructOCR

# Initialize StructOCR Client
client = StructOCR(os.environ["STRUCTOCR_API_KEY"])

def scan_vietnam_passport():
    image_path = "vietnam_passport_sample.jpg"

    try:
        print(f"Scanning {image_path}...")
        result = client.scan_passport(image_path)

        if result.get('success'):
            data = result['data']
            print("✅ Passport Extraction Successful!")
            print(f"Passport #:  {data.get('passport_number')}")
            print(f"Name:        {data.get('given_names')} {data.get('surname')}")
            print(f"Nationality: {data.get('nationality')}")
            print(f"DOB:         {data.get('date_of_birth')}")
        else:
            print(f"❌ Extraction Failed: {result.get('error')}")

    except Exception as e:
        print(f"Error: {e}")

if __name__ == "__main__":
    scan_vietnam_passport()

JSON Response Example

The Python SDK returns a dictionary matching this normalized JSON structure.

{
  "success": true,
  "data": {
    "type": "passport",
    "country_code": "VNM",
    "nationality": "VNM",
    "passport_number": "C1234567",
    "surname": "NGUYEN",
    "given_names": "VAN A",
    "sex": "M",
    "date_of_birth": "1990-09-02",
    "place_of_birth": "HA NOI",
    "date_of_issue": "2023-01-15",
    "date_of_expiry": "2033-01-15",
    "issuing_authority": "IMMIGRATION DEPARTMENT"
  }
}