Skip to main content

DyScan Protect Web Integration

Implement a credit card verification challenge in your web application​

Overview​

DyScan Protect Web helps merchants prevent stolen credit card fraud and account takeover (ATO) fraud on their web applications. For an overview of stolen credit card and ATOs, as well as an explanation of how DyScan Protect Web helps, see our documentation here.

Prerequisites​

  1. Request an API Key from Dyneti.

  2. Add the DyScan Web client script to your page

    <script src="https://dyscanweb.dyneti.com/static/front_end/dist/client.js"></script>

  3. Provide the domains on which the integration will be hosted to Dyneti.

Integration Options​

There are three ways of integrating DyScan Protect with your web application.

1. Modal Flow​

  1. Your user is prompted to verify their credit card.
  2. Once your user acknowledges they understand the prompt above, the Dyneti modal will appear over your page.
  3. Your user is prompted to scan their card with their camera.
  4. Your user holds their credit or debit card up to their smartphone camera so that the digits are visible. The video stream is sent back to Dyneti servers, where the images are processed by Dyneti's proprietary deep learning models.
  5. The card images are redacted and stored for use through our Reviews API. The unredacted images are deleted immediately after use.
  6. Dyneti's decision on whether or not a card was fraudulent and why as well as whether cardholder name and number match what we expected are returned back to your backend via a POST request. You may also fetch a scan result from our Scan Results API (see below for details). Your front-end code is notified that the scan is complete.
  7. Please see the Modal Flow documentation for implementation guidance and details.

2. QR Code Flow​

  1. Your user is prompted to verify their credit card (Dyneti does not supply this UI, but can offer suggestions on request).
  2. Once your user acknowledges they understand the prompt above, they are directed to a QR code supplied by Dyneti, and prompted to scan it with their smartphone camera.
  3. Your user scans their QR code with their smartphone camera, and are sent either to Dyneti's card scanning flow in your mobile app, or to a mobile webpage. Once they are there, they are prompted to scan their card with their smartphone camera.
  4. Your user holds their credit or debit card up to their smartphone camera so that the digits are visible. The video stream is sent back to Dyneti servers, where the images are processed by Dyneti's proprietary deep learning models.
  5. The card images are redacted and stored for use through our Reviews API. The unredacted images are deleted immediately after use.
  6. Dyneti's decision on whether or not a card was fraudulent and why as well as whether cardholder name and number match what we expected can be fetched from our Scan Results API (see below for details).

Please see the QR Code Flow documentation for implementation guidance and details.

3. Custom View Flow​

  1. You prompt your user to verify their credit card.
  2. You show your card scanning UI. You specify where to attach the DyScan iframe.
  3. Your front-end code will receive callbacks with the current state of the scan. You can update your UI to show progress, errors, or prompts required
  4. Your user holds their credit or debit card up to their camera so that the digits are visible. The video stream is sent back to Dyneti servers, where the images are processed by Dyneti's proprietary deep learning models.
  5. The card images are redacted and stored for use through our Reviews API. The unredacted images are deleted immediately after use. The authenticity and integrity of the scan can be verified using our Integrity Check API.
  6. Dyneti's decision on whether or not a card was fraudulent and why as well as whether cardholder name and number match what we expected can be fetched from our Scan Results API (see below for details). Your front-end code is notified that the scan is complete.

Please see the Custom View Flow documentation for implementation guidance and details.

Stripe token generation​

Dyneti can generate Stripe tokens with the results of a card scan. Please see the page Generate a Stripe token from a scan for details.