Skip to content

Get virtual card data

To retrieve the virtual card information, use the following endpoint:

GET https://[base_url]/v1/virtual-cards/{virtual_card_id}/data

Endpoint response

Status code: 200

{
    "number": "ZscNSVjQJVmV3gkebLeAAYcidmgiy9Oa2uwraYGIe5e6YZ/GmqKmMdxqXSpCJmXUR+u5da+FLeLv7iMkpm58T34GcHJ9tWOgYlMalRkbZYRMwTADpa8Gx/TLo3S6Fmq2nilgz1xg77wN11yHpjdHzYFVcSXTNWXFixA0E9Cfvy0mUqTnjtdbsCgUFZDgCbxnbLuuF0rU++VJsFDU+z/LILeGmU9U/2g0/sqqCsoCespbvPBmogZllTbi+JRa5e3VoydC1l3SOVaWW8DNZRQN7Kmo5773SruvDe1q8X3/l+QI3TkjiTyXbqO+sVCNqd8KWAZIlQCHBdFkSomvZSvtag==",
    "name": "IgKU4h7l+3DvQT1/Zyp6EZw26MTgeeLLDXdZwNdv/p71Y/sJ52GB3KNPZb5fTQ0nwjIkrPauMRZmweoJhty0tc2smgpvqfrcRIlREqMgvwLlkiBGLXEOJTf7E7hOctkbspG4qg8oZI+zqpqKasFUGgAk+rhRiVID6DUXkfp2KaEFk6xy4hxI1opEB6qfwC/gzKtUapmXttX5P0WPMwE5l1mNLLiwazL4PNkoAGrGLAuzDV6Thmju6xTxyWOV3phl9KPzPKbFQcDZBZt+OWABStwZsm2onA0WyB7Qhbd/47O8uUYmjz0eS+owulpNNY+W0Qs1ORtYD0pVxBLgVBiXBg==",
    "cvc": "R6OonMmd/U7oSSOBHp7o+Xa9aK4WxYIhe8RdOymdVCf8IXhY4L71+BZENGrqw+vYCFkdiA/sEwRNkDFqM9j0RXqyc1CmpU2nDtbAnMczjwkAVvKTIe3tyc/sRWcq2RFBXyFpPtD8BwY/GHrDLMLkZvNC6Z2cJy7Rvip4xvJrRjdzC+1sdMBMyEJeQXL6qPb1d3VrXiVFDXu9jZYnwZnnK/W1MXu6ad3+fGBZaoMU2gPYQIaOkfCedN+qaCsydAN720IPfyXWOYKpSWrOWLCcRQXUgRRwiKc+AldM4WD8KkiffQd5wIkhQqqevKhKRTZlPA46VcfmlZphvuFn9VncXg==",
    "expiration": "YCfwXIn4H1u0VVlYd8HEz1WAPqTYQmEQjQdXL6OSMRLCVnliys5OciEduE1xcnJl83ZXXVdrPp6OKM900CHtoVmAk25HbSnFOLzt3kb1e0UnpQ/L1PG7HyD4qefASzeASmYsjoTQpYTZ1caAC/cWg41wy0D/CRINHBPyZk7ZuE63UsAf0hmhDRzNZ/Afp4HDALNlUL1BlPjshYdqj+CBn8cJyk+xaibaGfd4LR7KJ6hVJtWnuyziUmXR1xOAjuINZOAtCO14GQ1EZearHYYTUiNuSWtIoz8K7HIsjxFM1XIpdDy4NSbj0QDAcZLujKLbNXvUZJF0sA/aQP+/90ATpQ=="
}

Decrypting Returned Data

Once you receive the response, you need to decrypt the returned data. You can use the following example code:

JavaScript Code:

const forge = require('node-forge');

const publicKey = Buffer.from(PUBLIC_KEY_ENCRYPT, 'base64');
const privateKey = Buffer.from(PRIVATE_KEY_ENCRYPT_F, 'base64');

const publicKeyPEM = forge.pki.publicKeyFromPem(forge.util.decodeUtf8(publicKey));
const privateKeyPEM = forge.pki.privateKeyFromPem(forge.util.decodeUtf8(privateKey));

const valueToDecrypt = "h8qC/262kFF7R85kULqx+waIg==";

const decodedData = Buffer.from(valueToDecrypt, 'base64');

const decryptedValue = privateKeyPEM.decrypt(decodedData, 'RSA-OAEP', {
    md: forge.md.sha256.create(),
    mgf1: {
        md: forge.md.sha256.create()
    }
});

If the decryption process is successful, you should see the card information in the following format:

{
    "number": "5534 6133 8899 9884",
    "name": "Hyperguest Reservas",
    "cvc": "982",
    "expiration": "08/30"
}

Status code: 400, 401, 403, 404

{
 "code": "Status code",
 "message":"Error description",
 "detail": "Error details"
}