# Decrypt a Token

Retrieve the original payment data associated with a specific token. This endpoint requires authentication and is intended for use by authorized clients only.

Endpoint: POST /token-service/tokens/sensitive-data
Version: 0.0.8
Security: bearerAuth

## Request fields (application/json):

  - `token` (string, required)
    Token that would be decrypted.
    Example: "e4eaaaf2-d142-11e1-b3e4-080027620cdd"

  - `types` (array)
    Type of decrypted details that would be returned.
    Example: ["ACH","PAN"]

## Response 200 fields (application/json):

  - `responseCode` (string, required)
    A code that represents the outcome of the transaction
    Example: "0"

  - `responseMessage` (string)
    A list of brief descriptions about the error encountered. If multiple messages need to be returned, it will be separated with ';' character
    Example: "An unexpected system error occurred. Please check with support."

  - `token` (string)
    Token in UUID format
    Example: "85ce5afd-31b2-4612-a6ef-c1e2aba3ca71"

  - `formatPreservedToken` (string)
    Format preserved token
    Example: "4927384619273842"

  - `cryptcard` (string)
    Direct token
    Example: "4TestYx9OuN8145"

  - `bankAccount` (object)
    Bank account information for ACH tokens

  - `bankAccount.accountNumber` (string, required)
    The bank account number.
    Example: "459887746321Z"

  - `bankAccount.routingNumber` (string, required)
    The bank routing number.
    Example: "123456789012"

  - `bankAccount.accountType` (string, required)
    The type of bank account.
    Enum: "Savings", "Checking"

  - `bankAccount.tenderType` (string)
    The bank tender type.
    Enum: "Consumer", "Commercial"

  - `creditCard` (object)
    Credit card information for PAN tokens

  - `creditCard.cardNumber` (string, required)
    The credit card number.
    Example: "4111111111111111"

  - `creditCard.expiration` (string)
    Expiration date of the card
    Example: "1230"

  - `creditCard.bin` (string)
    Bank Identification Number
    Example: "40212300"

  - `creditCard.category` (string)
    Only present for CC: credit card, debit card, cash card
    Example: "Credit Card"

  - `creditCard.lastFour` (string)
    Only present for CC: last 4 of card number
    Example: "4444"

  - `creditCard.binLevel` (string)
    Hierarchical level or classification of the card
    Example: "Platinum"

  - `creditCard.binLength` (integer)
    Only present for CC: BIN length
    Example: 8

  - `creditCard.network` (string)
    Only present for CC: card brand like Visa
    Example: "VISA"

  - `creditCard.isoCountry` (string)
    Country code representing the country associated with the payment account
    Example: "UNITED STATES OF AMERICA (THE)"

  - `creditCard.isoCountryCode` (string)
    Country code indicating the country where the payment account's issuing institution is located
    Example: "840"

  - `creditCard.isInternational` (boolean)
    Flag indicating whether the payment account is considered international

  - `dpan` (object)
    Digital Primary Account Number (DPAN) information

  - `dpan.applicationPrimaryAccountNumber` (string)
    Application Primary Account Number (DPAN)
    Example: "4111111111111111"

  - `dpan.applicationExpirationDate` (string)
    Application expiration date
    Example: "2025-12-01T00:00:00Z"

  - `dpan.currencyCode` (string)
    Currency code
    Example: "840"

  - `dpan.transactionAmount` (number)
    Transaction amount
    Example: 2089

  - `dpan.cardholderName` (string)
    Cardholder name
    Example: "John Doe"

  - `dpan.deviceManufacturerIdentifier` (string)
    Device manufacturer identifier
    Example: "040010030273"

  - `dpan.paymentDataType` (string)
    Payment data type
    Example: "3DSecure"

  - `dpan.onlinePaymentCryptogram` (string)
    Online payment cryptogram
    Example: "AgAAAAAAAIR8CQrXcIIBAAA="

  - `dpan.eciIndicator` (string)
    ECI indicator
    Example: "05"

  - `dpan.authenticationResponses` (array)
    Authentication responses
    Example: [{"merchantIdentifier":"...","authenticationData":"...","transactionAmount":"2000"}]

  - `dpan.authenticationResponses.merchantIdentifier` (string)

  - `dpan.authenticationResponses.authenticationData` (string)

  - `dpan.authenticationResponses.transactionAmount` (string)

  - `dpan.expiration` (string)
    Expiration date of the DPAN data
    Example: "2025-12-01T00:00:00Z"

  - `dpan.digitalWallet` (string)
    Type of digital wallet

  - `mpan` (object)
    Mobile Primary Account Number (MPAN) information

  - `mpan.merchantTokenIdentifier` (string)
    Merchant token identifier
    Example: "DNITHE302483952"

  - `mpan.merchantTokenMetadata` (object)
    Merchant token metadata (JSON string)
    Example: {"merchantId":"123456","tokenRequestorId":"40010030273"}

  - `mpan.merchantTokenMetadata.cardMetadata` (object)

  - `mpan.merchantTokenMetadata.cardMetadata.longDescription` (string)

  - `mpan.merchantTokenMetadata.cardMetadata.cardCountry` (string)

  - `mpan.merchantTokenMetadata.cardMetadata.shortDescription` (string)

  - `mpan.merchantTokenMetadata.cardMetadata.fpanSuffix` (string)

  - `mpan.expiration` (string)
    Expire date of the MPAN data
    Example: "0728"

  - `networkToken` (object)
    Network token information

  - `networkToken.expiration` (string)
    Expiration date of the Network Token data
    Example: "1230"

  - `networkToken.correlationId` (string)
    A unique identifier used to correlate the tokenization request and response.
    Example: "abc123xyz-4567-8901-defg-2345hijk"

  - `networkToken.eci` (string)
    Electronic Commerce Indicator (ECI) value indicating the security level of the transaction.
    Example: "05"

  - `networkToken.cryptogram` (string)
    A cryptographic value generated for the transaction, used for authentication.
    Example: "AfQ1FAAAAAAAABYcV2V4AAAAAAA="

  - `networkToken.tokenProviderId` (string)
    Identifier of the token provider that issued the network token.
    Example: "VISA"

  - `networkToken.networkToken` (string)
    A network token with the same length as the card number it masks
    Example: "4222222222222222"