Tokens de rede

tokens de rede representam um avanço significativo no setor de processamento de pagamentos, atuando como substitutos digitais para detalhes confidenciais de cartões de pagamento, inclusive números de cartões de crédito. Emitidos por redes de pagamento, como Visa, Mastercard e American Express, esses tokens estão na vanguarda do aprimoramento da segurança das transações em nosso cenário digital em evolução.

Benefícios dos tokens de rede

Segurança aprimorada: Ao substituir os dados reais do cartão durante as transações, tokens de rede desempenham um papel fundamental no fortalecimento das medidas de segurança, reduzindo significativamente o risco de exposição a possíveis fraudes.
Integração perfeita: Com esforços mínimos de integração que aderem aos padrões token de rede da EMVCo, nossa solução garante um processo de implementação eficiente e sem interrupções, permitindo uma rápida adaptação em vários cenários de pagamento.
Atualizações automáticas: tokens de rede, gerenciados e atualizados automaticamente pelas redes de cartões, contribuem para reduzir o atrito com o comprador e os pagamentos recusados. Essa adaptabilidade inerente garante uma taxa de autorização mais alta em comparação com as transações sem tokens de rede.

token de uso único vs. token abobadado vs. token de rede

token de uso único	token abobadado	token de rede
Ao usar o SDK da Yuno, reunimos todas as informações necessárias para processar o pagamento e as armazenamos em um token de uso único, independentemente do método de pagamento escolhido pelo cliente. Você usará o token ao criar o pagamento. Observe que esse token funciona apenas uma vez. Você precisará gerar um novo token de uso único para cada sessão de checkout criada.	Um token protegido é criado pela Yuno quando um método de pagamento é registrado e armazenado com as informações do cliente. Você pode usar o token abobadado criado para identificar o método de pagamento em pagamentos futuros.	Representações digitalizadas de informações confidenciais de cartões de pagamento, como números de cartões de crédito, emitidas pelas principais redes de pagamento, como Visa, Mastercard ou American Express. Esses tokens têm a finalidade de substituir os dados reais do cartão nas transações, aumentando assim a segurança ao minimizar a exposição a possíveis atividades fraudulentas.

Quando o recurso de tokens de rede é ativado, a Yuno gera tokens de rede para todos os cartões registrados e armazenados com segurança em nosso cofre. Essa abordagem está totalmente alinhada com a forma como a tokenização de rede deve funcionar, conforme definido pela Visa e pela Mastercard após a validação do cartão, garantindo melhor desempenho, segurança e confiabilidade em transações recorrentes e futuras. Os cartões não armazenados na Yuno - como os cartões de uso único - são naturalmente excluídos desse processo, uma vez que a tokenização de rede não é aplicável nesses casos.

Ciclo de vida tokens de rede

tokens de rede podem ter os status descritos na seção abaixo.

Status	Descrição
Criado	O status inicial de um token de rede que foi criado.
Ativo	O token de rede está ativo e pode ser usado para fazer um pagamento.
Suspenso	Tokens podem ser suspensos se o titular do cartão entrar em contato com o emissor e solicitar que os pagamentos de um determinado comerciante sejam bloqueados.
Cancelado	Tokens podem ser cancelados por vários motivos, como o fechamento da conta do titular do cartão associada ao token .

Tipos de integração

Para fazer pagamentos com tokens de rede, você tem duas opções disponíveis:

Permita que a Yuno provisione e colete tokens de rede.
Use seus tokens de rede existentes.

1. Permita que a Yuno forneça e colete tokens de rede

Adquirimos tokens de rede das principais redes de cartões, incluindo Visa, Mastercard e American Express. Esses tokens são armazenados com segurança na infraestrutura da Yuno e são usados no lugar dos cartões reais durante o processo de autorização.

Não há necessidade de integração adicional para acessar os benefícios da tokenização de rede quando a Yuno gerencia a solicitação e o acúmulo de tokens em seu nome. Basta seguir o fluxo de trabalho de pagamento padrão correspondente à sua integração específica de pagamento com cartão. A Yuno lida perfeitamente com o processo, substituindo os detalhes do cartão por um token de rede, resultando em taxas de autorização mais altas.

Para ativar pagamentos usando tokens de rede, entre em contato com nossa equipe de suporte para fornecer ou solicitar as credenciais necessárias.

Exemplo de resposta

Durante a inscrição ou a criação do pagamento, você receberá as informações básicas do token de rede usado na operação correspondente.

{
    "description": "Test",
    "account_id": "{{account-code}}",
    "merchant_order_id": "0000023",
    "country": "DE",
    "merchant_reference" : "reference-{{$randomUUID}}",
    "amount": {
        "currency": "EUR",
        "value": 5000
    },
    "customer_payer": {
        "id":"967ecd18-d898-4b88-9400-dd5b01b18edc"
    },
    "workflow": "DIRECT",
    "payment_method": {
        "type":"CARD",
        "vaulted_token": "61d49d6e-7c0e-49d0-be79-7eb08871f998",
        "detail": {
           "card": {
               "network_token":{
                  "network":"MASTERCARD",
                  "status": "ACTIVE",
                  "par":"V0010014622074319305424002620",
                  "token_data":{
                    "iin":"45079900",
                    "lfd": "0010",
                    "expiration_month":"10",
                    "expiration_year":"2028",
                    "response":{
                      "code":"succeeded",
                      "message": "Transaction Succeeded"
                    }
                  }
              }
           }
        }
    }
  [...]
}

2- Use seus tokens de rede existentes

Após configurar as credenciais necessárias em sua conta Yuno e entrar em contato com nossa equipe de suporte, você estará pronto para executar transações tokenizadas sem problemas.

❗️
Com essa opção, a Yuno atua apenas como uma passagem para as informações do token de rede. O comerciante deve fornecer as informações necessárias sobre os tokens de rede para que a Yuno possa compartilhá-las com os parceiros de pagamento upstream.

As transações de token de rede utilizam solicitações de API de transação de pagamento existentes. Semelhante à criação de um pagamento com detalhes de cartão de crédito, quando um comerciante usa a API Yuno para finalizar um pagamento, ele pode optar por incluir o objeto "network_token" para usar um token de rede para a transação.

Campos de solicitação de pagamento

Junto com o card_data esses campos devem ser adicionados ao objeto payment_method.detail.card.network_token.token_data para enviar pagamentos usando a API da Yuno.

Campo	Tipo	Descrição
`number`	número	[Obrigatório] - Número do Token sem nenhum separador. (MAX 19; MIN 8) - disponível somente para comerciantes certificados pela PCI
`holder_name`	string	Nome completo do titular do cartão como aparece no token (MAX 26; MIN 3) - disponível apenas para comerciantes certificados pela PCI
`expiration_month`	inteiro	[Obrigatório] - Mês de expiração do Token- MM (MAX 2; MIN 2) - disponível apenas para comerciantes certificados pela PCI
`expiration_year`	inteiro	[Obrigatório] - Ano de expiração do Token- AAAA (MÁX. 4; MÍN. 4) - disponível apenas para comerciantes certificados pela PCI
`cryptogram`	string	[Obrigatório] - O criptograma exclusivo gerado pelo emissor para o token de rede em uso na transação. Opcional para transações recorrentes
`electronic_commerce_indicator`	string	[Necessário apenas para determinados provedores] - Se o token tiver sido autenticado pela Mastercard, o campo deverá ser definido como 02. Para tokens Visa ou não autenticados, não é necessário enviar o campo.
`token_requestor_id`	string	[Necessário apenas para determinados provedores] - ID do solicitante do Token do comerciante

Exemplo de Request

{
  "description": "Test",
    "account_id": "{{account-code}}",
    "merchant_order_id": "0000023",
    "country": "DE",
    "merchant_reference" : "reference-{{$randomUUID}}",
    "amount": {
        "currency": "EUR",
        "value": 5000
    },
    "customer_payer": {
        "id":"967ecd18-d898-4b88-9400-dd5b01b18edc"
    },
    "workflow": "DIRECT",
    "payment_method": {
        "type":"CARD",
        "detail": {
           "card": {
             "card_data": {
                "number": "4000000000001026",
                "holder_name": "John Doe",
                "expiration_month": 1,
                "expiration_year": 26,
                "security_code": "123"
              },
             "network_token":{
                  "token_data":{
                    "number":"4000000000001026",
                    "holder_name":"Jhohn Doe",
                    "expiration_month":1,
                    "expiration_year":26,
                    "cryptogram":"CCADBxYzRTBBXXXXXXXYZa0AbZD"
                  }
              }
           }
        }
    }
  [...]
}

Exemplo de resposta

{
    "description": "Test",
    "account_id": "{{account-code}}",
    "merchant_order_id": "0000023",
    "country": "DE",
    "merchant_reference" : "reference-{{$randomUUID}}",
    "amount": {
        "currency": "EUR",
        "value": 5000
    },
    "customer_payer": {
        "id":"967ecd18-d898-4b88-9400-dd5b01b18edc"
    },
    "workflow": "DIRECT",
    "payment_method": {
        "type":"CARD",
        "detail": {
           "card": {
              "card_data": {
                        "holder_name": "John Doe",
                        "iin": "48710499",
                        "lfd": "9910",
                        "number_length": 16,
                        "security_code_length": 3,
                        "brand": "VISABANCONTACT",
                        "issuer_name": "BNP PARIBAS FORTIS NVSA",
                        "issuer_code": null,
                        "country_code": "BE",
                        "category": "CLASSIC",
                        "type": "DEBIT",
                        "expiration_month": 3,
                        "expiration_year": 30,
                        "fingerprint": "4d486017-afa0-4f2c-ba51-a09af528bd38"
                        [...]
                    }, 
              "network_token":{
                  "network":"MASTERCARD",
                  "status": "ACTIVE",
                  "par":"V0010014622074319305424002620",
                  "token_data":{
                    "iin":"45079900",
                    "lfd": "0010",
                    "holder_name":"Jhohn Doe",
                    "expiration_month":10,
                    "expiration_year":28,
                    "response":{
                      "code":"succeeded",
                      "message": "Transaction Succeeded"
                    }
                  }
              }
           }
        }
    }
  [...]
}