Show Card PAN via HTML (iframe)

Overview of the Implementation Steps

  1. Embed an iFrame in your application to securely display card data.

  2. Host a custom CSS stylesheet at a publicly accessible URL to define card UI styling.

  3. Generate a signed access URL via the API endpoint.

  4. Load the signed URL dynamically inside the iFrame to securely display the card details.

Step 1: Embed an iFrame to Display Card Data

To securely display sensitive card data, embed an in your web or mobile app. This iFrame will dynamically load a card’s PAN, expiration date, and CVV via an API request.

Example: Adding an iFrame to your webpage

<iframe
    id="card-data-iframe"
    src=""  <!-- The secure URL will be set dynamically -->
    frameborder="0"
    width="100%"
    height="250px">
</iframe>

Step 2: Create and Host a Custom CSS Stylesheet

To customize the card UI, create a CSS file and host it at a publicly accessible URL. This stylesheet will define how the card data appears inside the iFrame.

Example:

Skeleton HTML

Custom CSS (styles.css)

Hosting the Stylesheet:

  • Upload to your server or a cloud storage provider.styles.css

  • Ensure the stylesheet is publicly accessible (e.g., ).https://yourdomain.com/styles.css

Step 3: Generate a Signed URL for the iFrame

To load the iFrame securely, request a signed access URL by calling the POST /services/v1/card/pan/{cardId}/reveal-html API endpoint.

Note: The field is optional. If provided, the accessUrl will be encrypted for enhanced security.

Request Body Example

Response Example

The expires in 60 secondsaccessUrl, ensuring security.

publicKeyis optional, if provided the returned will be in encrypted format.accessUrl

Encrypting your accessUrl

To decrypt: publicKey accessUrl

  1. Base64 Decode the message.

  2. Decrypt using your private key.

Last updated