Implementação da Rotina de Geração de Token e Criptograma de Cartão

[lucassgnm]

Descrição

Adicionar uma nova funcionalidade ao projeto para implementar as rotinas de geração de token e criptograma de cartão, com foco no suporte completo ao protocolo de tokenização de bandeira Visa. Essa funcionalidade é essencial para aumentar a segurança nas transações de e-commerce, substituindo o número do cartão por um token exclusivo de bandeira combinado com um criptograma.

Importante: Identificamos que os testes para a tokenização da bandeira Visa ainda não estão presentes no projeto. A Visa tem incentivado a adoção dos tokens por estabelecimentos e passou a aplicar uma multa sobre o valor das transações realizadas sem token. Assim, a implementação dessa funcionalidade é prioritária para garantir conformidade com os padrões da bandeira e evitar custos adicionais para os clientes.

---

1. Geração do Token do Cartão

Descrição

A rotina deve enviar os dados do cartão e do comprador para o endpoint /v1/tokenization/token, que retornará um token exclusivo associado ao cartão.

Detalhes do Endpoint

URL: /v1/tokenization/token
Método: POST

Request Body:

{
  "customer_id": "customer_45678900, 123.456.789-00 ou 12345678900",
  "card_pan": "4622943120000493",
  "card_pan_source": "ON_FILE, MANUALLY_ENTERED ou VIA_APPLICATION",
  "card_brand": "VISA, MASTERCARD",
  "expiration_year": "2023",
  "expiration_month": "07",
  "security_code": 1234,
  "email": "[email protected]"
}

---

2. Geração do Criptograma do Cartão

Descrição

A rotina deve enviar o token gerado previamente (network_token_id) e os dados adicionais da transação para o endpoint responsável por gerar o criptograma.

Detalhes do Endpoint

URL: /v1/cryptogram/generate
Método: POST

Request Body:

{
  "network_token_id": "1b110aaa71934ae492bff48baab9af81",
  "transaction_type": "CIT ou MIT",
  "cryptogram_type": "VISA_TAVV ou MC_DSRP_LONG",
  "amount": 1000,
  "customer_id": "customer_45678900",
  "email": "[email protected]",
  "card_brand": "VISA ou MASTERCARD"
}

---

Referências

• Documentação da API: [link para a documentação]