Web to Mobile Handoff 📲


Many users encounter difficulties in enabling their webcams on desktop browsers, leading to a frustrating experience during the scanning process. Additionally, most laptop and desktop webcams struggle with low light settings and card movement, further impacting the success rate of scans.

To address these challenges, we have introduced the "Handoff" feature in our React widget. This feature allows users to seamlessly switch to their mobile devices to complete the scanning process when faced with difficulties or failures on the desktop.


The Handoff feature is designed to be triggered under specific conditions such as setup failure, camera failure, or after two unsuccessful scanning attempts. When activated, the feature generates a magic link and displays a QR code that users can scan with their mobile devices to continue the process.

A standalone endpoint is responsible for validating the magic link and providing the user with the necessary instructions on their mobile device. Once the scanning is successfully completed on the mobile device, the user is instructed to return to the desktop browser. The desktop widget then updates automatically to reflect the success and returns the results locally.

Note: Handoff works seamlessly with our Eligibility and Payer Match features.


To enable and configure the Handoff feature in your React widget, use the webToMobileHandoffConfig prop:

    enabled: true,
    companyName: "HealthHaven"
  • enabled: Set to true to enable the Handoff feature.

  • companyName: (Optional) Specify the name of your company to be displayed to the patient during the handoff process.

QR Code and URL

The QR code displayed to the user will be comprised of a URL that looks like https://capture.cardscan.ai/?token=<short-lived-token>. This site guides the user through the scanning process and, once completed, instructs the user to continue on their desktop.


Alternative the urlBase prop can be used to generate a QR code that will direct the user to the provided URL, allowing for a customized scanning experience on your own domain.

  enabled: true,
  urlBase: "https://capture.yourURL.com",
  • enabled: Set to true to enable the Handoff feature.

  • urlBase: (Optional) Specify the base URL to direct the user to a page on your mobile-friendly web app or a standalone site for the scanning process. This allows for complete customization of the landing page and keeps the user within your company's domains.

Developer Responsibilities

When opting for self-hosting, the developer is responsible for the following:

  • Providing Instructions to the Mobile User: The landing page should guide the user through the scanning process on their mobile device.

  • Exchanging the Short-lived Token for a JWT: The mobile app or web page should handle the exchange of the short-lived token provided in the QR code for a JWT (JSON Web Token) to authenticate the scanning session.

  • Loading the CardScanView with the Token: The mobile app or web page should load the CardScanView component with the obtained JWT to initiate the scanning process.

  • Instructing the User to Return to the Desktop: Upon successful completion of the scanning process on the mobile device, the user should be instructed to return to their desktop browser to continue their journey or view the results.


To provide a clearer understanding of the Handoff feature in action, we have created a video demo that showcases the seamless transition from desktop to mobile scanning.

Last updated