Token CVV

O CVV (Valor de verificação do cartão), é o código de segurança composto por três ou quatro dígitos, utilizado nas compras online, o código substitui a senha usada em estabelecimentos físicos. Com a finalidade de garantir que no ato da compra o cliente tenha o seu cartão em mãos, evitando fraudes. A tokenização é um método de substituição dos dados sensíveis do portador (CVV), por um token, para que a experiência de pagamento digital seja mais segura.

Cenário de utilização

O recurso de tokenização do CVV é normalmente utilizado em transações usando dados de cartão de crédito já armazenados no cofre, no qual os clientes desejam passar o CVV de forma segura através de um token, ao invés do CVV em texto plano. Para isso, utiliza-se a solução de Token CVV, garantindo que a aplicação dos clientes não consiga enxergar o conteúdo desse token.

O token é invalidado após o seu uso e/ou pelo tempo de expiração, sendo impossível utilizá-lo futuramente. Para isso é necessário gerar um novo token e informar esse na transação.

Exemplo de tokenização do CVV

curl --location 'https://api.malga.io/v1/tokens' \
     --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
     --header 'X-Api-Key: <YOUR_SECRET_KEY>' \
     --header 'Content-Type: application/json' \
    --data '{
        "cvvUpdate": "410"
    }'
< HTTP/2 201
< content-type: application/json; charset=utf-8
{
    "tokenId": "72964dfb-4a81-43c6-a231-1944c54adc7f"
}

Exemplo de transação utilizando a tokenização CVV

curl --location 'https://api.malga.io/v1/charges' \
     --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
     --header 'X-Api-Key: <YOUR_SECRET_KEY>' \
     --header 'Content-Type: application/json' \
    --data '{
        "merchantId": "147d838e-2507-47cd-b371-0379be09c904",
        "amount": 150,
        "currency": "BRL",
        "statementDescriptor": "Pedido #231 loja joão",
        "capture": true,
        "orderId": "7171717171",
        "description": "descrição"
        "paymentMethod": {
            "paymentType": "credit",
            "installments": 1
        },
        "paymentSource": {
            "sourceType": "card",
            "cardId": "f2e362f3-2527-485f-8bc7-483289436a89",
            "tokenCvv": "72964dfb-4a81-43c6-a231-1944c54adc7f"
        }
    }'
< HTTP/2 201
< content-type: application/json; charset=utf-8
{
   "id": "985d784f-24c5-4faa-ba6a-cb8f2d21b49c",
    "clientId": "1b2c2ef7-03cd-4012-9d1c-aff50551fae3",
    "merchantId": "95d89ff9-751b-4cc7-b45c-d4d886cf6589",
    "description": "0a95395b-f12f-4d13-8c00-9f76133645e7",
    "orderId": "231ef650-65c5-457f-937c-bb2ef8961ca8",
    "createdAt": "2023-08-04T14:02:05.082Z",
    "amount": 100,
    "originalAmount": 100,
    "currency": "BRL",
    "statementDescriptor": "Token CVV",
    "capture": true,
    "isDispute": false,
    "status": "failed",
    "paymentMethod": {
        "installments": 1,
        "paymentType": "credit"
    },
    "paymentSource": {
        "sourceType": "card",
        "cardId": "4c5da4c4-c3c4-4c7f-bc00-7bfddec13dbc"
    },
    "transactionRequests": [
        {
            "id": "0d42ceca-1443-4e39-a852-0276dc217980",
            "createdAt": "2023-08-04T14:02:05.166Z",
            "updatedAt": "2023-08-04T14:02:05.271Z",
            "idempotencyKey": "a50a659f-1851-4d7f-b7c4-cd6a307d40bb",
            "providerId": "00e1997a-5204-465e-bc77-1b675ac8757e",
            "providerType": "SANDBOX",
            "transactionId": "2767078",
            "amount": 100,
            "authorizationCode": "1547251",
            "authorizationNsu": "6783923",
            "requestStatus": "failed",
            "requestType": "authorization",
            "responseTs": "41ms",
            "providerError": {
                "retryable": false,
                "declinedCode": "invalid_cvv",
                "message": null,
                "networkDeniedMessage": "Invalid CVV",
                "networkDeniedReason": "sandbox invalid cvv"
            }
        }
    ]
}

Para saber mais sobre a Tokenização confira em nossa documentação.

Comece na Malga

Conexões

Guias

Serviços adicionais

Cenário de utilização

Exemplo de tokenização do CVV

Exemplo de transação utilizando a tokenização CVV

​Cenário de utilização

​Exemplo de tokenização do CVV

​Exemplo de transação utilizando a tokenização CVV

Cenário de utilização

Exemplo de tokenização do CVV

Exemplo de transação utilizando a tokenização CVV