Create a payment passkey

Overview

After the end user signs in to the issuer application and selects a card, they can create a payment passkey.

The payment passkey is linked to the selected card and device.

The flow differs by payment network.

User experience

Visa

Visa user experience for payment passkey creation.

Visa requires a short initialization step in an issuer-hosted web page.

This step gets the payment passkeys so the issuer application can display them on the next screen.

Run this step once every 8 minutes for each device.

The selected card does not affect this timer.

Mastercard

Mastercard user experience for payment passkey creation.

You cannot check whether a payment passkey already exists on the device before the flow starts.

Let the end user start the creation flow each time.

If a payment passkey already exists, Mastercard shows a different page during the flow.

Flow

1. Initialize and get payment passkeys (Visa only)

Visa initialization flow for payment passkey creation.

This step is required for Visa only.

The D1 SDK redirects the end user to an issuer-hosted web page, such as a loading page.

That page loads the D1 JavaScript SDK.

The D1 JavaScript SDK then starts the Visa SDK in a hidden iframe.

If the same device completed this step in the last 8 minutes, the D1 SDK skips it automatically.

2. Create the payment passkey

Payment passkey creation flow for Visa and Mastercard.

When the creation flow starts, the D1 SDK redirects the end user to the Visa or Mastercard page.

The payment network authenticates the end user and creates the payment passkey on the device.

After the flow succeeds, a notification is sent to the issuer backend.