Skip to main content
Version: v3000

createBlinkCard

@microblink/blinkcard

@microblink/blinkcard / createBlinkCard

Function: createBlinkCard()

createBlinkCard(options): Promise<BlinkCardComponent>

Creates a BlinkCard component with all necessary SDK instances and UI elements.

This function initializes the complete BlinkCard scanning system including:

  • BlinkCard Core SDK for document processing
  • Camera Manager for video capture and camera control
  • UX Manager for coordinating scanning workflow
  • Camera UI for video display and camera controls
  • Feedback UI for scanning guidance and status

The function sets up the entire scanning pipeline and returns a component object that provides access to all SDK instances and destruction capabilities.

Parameters​

options​

Configuration options for the BlinkCard component

cameraManagerUiOptions?​

Partial<CameraManagerUiOptions>

Customization options for the camera manager UI. Controls camera-related UI elements like the video feed container and camera selection.

feedbackUiOptions?​

Partial<FeedbackUiOptions>

Customization options for the feedback UI. Controls the appearance and behavior of scanning feedback elements.

initialMemory?​

number

The initial memory allocation for the Wasm module, in megabytes. Larger values may improve performance but increase memory usage.

licenseKey​

string

The license key required to unlock and use the BlinkCard SDK. This must be a valid license key obtained from Microblink.

microblinkProxyUrl?​

string

The URL of the Microblink proxy server. This proxy handles requests to Microblink's Baltazar and Ping servers.

Requirements:

  • Must be a valid HTTPS URL
  • The proxy server must implement the expected Microblink API endpoints
  • This feature is only available if explicitly permitted by your license

Endpoints:

  • Ping: {proxyUrl}/ping
  • Baltazar: {proxyUrl}/api/v2/status/check

Example

"https://your-proxy.example.com"

resourcesLocation?​

string

The parent directory where the /resources directory is hosted. Defaults to window.location.href, at the root of the current page.

scanningSettings?​

Partial<{ anonymizationSettings: Partial<OverrideProperties<AnonymizationSettings, { cardNumberAnonymizationSettings: Partial<CardNumberAnonymizationSettings>; }>>; croppedImageSettings: Partial<CroppedImageSettings>; extractionSettings: Partial<ExtractionSettings>; inputImageMargin: number; livenessSettings: Partial<LivenessSettings>; skipImagesWithBlur: boolean; tiltDetectionLevel: DetectionLevel; }>

targetNode?​

HTMLElement

The HTML element where the BlinkCard UI will be mounted. If not provided, the UI will be mounted to the document body.

userId?​

string

A unique identifier for the user/session. Used for analytics and tracking purposes.

wasmVariant?​

"basic" | "advanced" | "advanced-threads"

The WebAssembly module variant to use. Different variants may offer different performance/size tradeoffs.

Returns​

Promise<BlinkCardComponent>

Promise that resolves to a BlinkCardComponent with all SDK instances and UI elements

Example​

const blinkCard = await createBlinkCard({
  licenseKey: "your-license-key",
  targetNode: document.getElementById("blinkcard-container"),
  feedbackUiOptions: {
    showOnboardingGuide: false
  }
});

// Add result callback
blinkCard.addOnResultCallback((result) => {
  console.log("Scanning result:", result);
});

// Clean up when done
await blinkCard.destroy();
Last updated on