Displaying card details

Precondition:

• An account must be created on the Wirex Pay Chain.
• A user entity must be created, with KYC completed and the phone number confirmed.
• A card in an active status is available.

Abstract:

Displaying card details allows users to view essential information related to their Wirex Pay Card. This feature enables users to access critical card details such as the full card number, expiration date, CVV code, and PIN code. By securely providing this information, Wirex Pay empowers users to manage their cards effectively and stay informed about their financial security.

Step 1: Obtain an Action Token via Confirmation API

Before accessing sensitive card information, it is essential to verify the user’s identity through a secure confirmation process. This involves making two API calls:

1. Request an Action Token: Initiate an Request SMS codeAPI call with GetCardDetails action_token parameter. This generates a token and delivers a One-Time Passcode (OTP) to the user via the configured channel (such as SMS or email).
2. Verify the Action Token: Once the user provides the OTP, verify it using the Verify SMS code API call. Upon successful verification, an action token is granted, enabling secure access to sensitive card details.

🚧

Note: The obtained action token is valid for 5 minutes and can be reused for all the steps below. Ensure the user completes their actions within this time frame.

Step 2: View Card Details (Number and Expiration Date)

After obtaining the action token, you can securely retrieve the card’s number and expiration date. Make an Get detailsAPI call to view card details, including the full card number and expiration date. Display the information securely, ensuring that the user is aware of the sensitivity of these details.

Step 3: Check the Card’s PIN

To access the card’s PIN, use the obtained action token to make a Get PIN API call. The response will provide the card’s PIN, which should only be displayed in a secure environment. Emphasize to users the importance of memorizing their PIN and avoiding sharing it.

Step 4: Check the Card’s CVV

Lastly, use the action token to make a Get CVV API call. The API response provides the card’s CVV, a critical piece of information for online transactions. Ensure that the CVV is displayed temporarily and remains encrypted when stored.