Reveal Virtual Cards

After generating a virtual card, you can use the revealVirtualCardByVirtualCardId mutation to access the card's details. By passing the virtualCardId as an argument, this mutation will reveal the following information:

• Card number
• Expiry date
• CVV
• Cardholder name
• Billing address

You can obtain the virtualCardId required for this mutation by using the VirtualCard or VirtualCardAuthorizationSetting objects.

Input

The reveal mutation only requires a virtualCardId input argument.

 {
  "virtualCardId": "7c57c381-4b19-49e4-bbb0-404a45166ee4"
}

Sample Query

Here’s an example of how to use the revealVirtualCardByVirtualCardId mutation:

mutation revealVirtualCardByVirtualCardId($virtualCardId: UUID!) {
  revealVirtualCardByVirtualCardId(virtualCardId: $virtualCardId) {
    cardNumber
    expiryMMYY
    cvv
    cardHolderName
    billingAddress {
      ...VirtualCardAddressInfoFragment
    }
  }
}

Sample Response

{
  "data": {
    "revealVirtualCardByVirtualCardId": {
      "cardNumber": "4111111560324603",
      "expiryMMYY": "02/2023",
      "cvv": "486",
      "cardHolderName": "Susan Jones",
      "billingAddress": VirtualCardAddressInfo
  }
} 

❗️

Only available to personal applications

Currently, only personal applications will be granted the scope to view virtual card numbers on an account. Publicly available applications looking to view virtual cards associated with an account will need to complete PCI certification and an attestation of PCI compliance.

Publicly available applications are able to view virtual card IDs and transaction details. They are not able to see the actual card numbers.