Reveal card details

POST

/integration/cards/{id}/encrypted-details

Early access - contact your account manager to enable cards for your organization.

Returns sensitive card data encrypted with your session key: the full card number and CVC for operation = cardDetails, or the PIN for operation = pin.

Each value is AES-GCM ciphertext (data) with its initialization vector (iv), both base64-encoded. Decrypt them on the cardholder's device with the session key from POST /integration/cards/{id}/encrypted-envelope, and never store or log the decrypted values.

Errors: 400 Bad Request if the encrypted session key is invalid or the envelope has expired; 404 Not Found if the card does not exist; 422 Unprocessable Content if the card is not active or frozen.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/json

Example

{
    "protocol": "string",
    "encryptedSessionKey": "string",
    "operation": "cardDetails"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://my.test-1.account.finlego.com/api/merchant/integration/cards//encrypted-details' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "protocol": "string",
    "encryptedSessionKey": "string",
    "operation": "cardDetails"
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "operation": "cardDetails",
    "pan": {
        "iv": "q3Jd2fX0bP1k9sLw",
        "data": "N2Y4ZTFhYzQ5ZDJiM2M1ZTZmN2E4YjljMGQxZTJmM2E="
    },
    "cvc": {
        "iv": "q3Jd2fX0bP1k9sLw",
        "data": "N2Y4ZTFhYzQ5ZDJiM2M1ZTZmN2E4YjljMGQxZTJmM2E="
    },
    "pin": {
        "iv": "q3Jd2fX0bP1k9sLw",
        "data": "N2Y4ZTFhYzQ5ZDJiM2M1ZTZmN2E4YjljMGQxZTJmM2E="
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error

Modified at 2026-09-29 11:11:16

Create encryption envelope

Set PIN