Overview

The SimpliFi Virtual Card SDK allows you to securely display sensitive card information (PAN, CVV) and manage PINs within your application. To ensure PCI-DSS compliance, these details are rendered directly from SimpliFi servers via a secure web page.

Base URL: https://{env}-virtualcard.simplifipay.com/simplifi-sdk/

Query Parameters:

Parameter	Type	Required	Description
token	String	Yes	Bearer token obtained from the Auth API.
cardUUID	String	Yes	The unique 36-character ID of the card to display.
userID	String	Yes	The unique 36-character ID of the cardholder.
action	String	Yes	The operation to perform (see list below).

Available Actions

Action	Description
view_card_detail	Reveal Card Number & CVV
set_pin	Set a new PIN for Physical Card
activate_card	Activate a new physical Card

Mobile Integration (React Native)

To integrate the SimpliFi Virtual Card SDK into a React Native application, you should use the official react-native-webview package (or a similar web view component). The SDK works by loading a secure web page directly from SimpliFi servers via a secure web page to ensure PCI-DSS compliance.

Install Dependency
Install the package in your project: npm install react-native-webview

Construct URL
Define a function to build the full URL, including all required query parameters:

token Bearer token obtained from the Auth API.

cardUUID The unique 36-character ID of the card to display.

userID The unique 36-character ID of the cardholder.

action The operation to perform

Render WebView Component

Use the WebView component from the package, passing the full constructed URL to the source prop. The secure page relies on JavaScript to render data, which the react-native-webview component generally supports by default.

Web Integration

To integrate this into a website (React, Vue, or plain HTML), use a standard HTML iFrame.

Create Element: Add an <iframe> tag to your page structure.

Set Source: Set the src attribute of the iframe to the full URL constructed above.

Styling: Ensure the iframe has sufficient height (approx. 600px) and width (100%) to display the card visually properly. No additional headers or authentication logic is needed inside the browser code; the token in the URL handles validation.

SimpliFi Virtual Card SDK Integration Guide

Overview#

Mobile Integration (React Native)#

Render WebView Component#

Web Integration#

Overview

Mobile Integration (React Native)

Render WebView Component

Web Integration