Processo de migração de Token

A migração de Token é o processo de transferência de números de cartões de um provedor existente para o cofre seguro da Yuno. Durante esse processo, um novo token é gerado para cada cartão, garantindo a continuidade e a segurança do processamento de pagamentos. O processo de migração token consiste em três etapas principais:

  1. O comerciante solicita o processo de migração de token de seu processador de pagamento atual.
  2. A Yuno e o provedor de pagamento colaboram para importar com segurança todos os dados do cartão para o cofre de token da Yuno.
  3. O comerciante usa a API de migração de token da Yuno para mapear os tokens do provedor de pagamento para o vaulted_tokens de Yuno.
📘

Primeira etapa

Para iniciar o processo de migração token , entre em contato com seu consultor de negócios na Yuno para avaliar a viabilidade e o cronograma do procedimento.

Importação de cartões de uma conta de gateway (etapas 1 e 2)

A importação de dados de cartão de uma conta de gateway envolve o manuseio de informações confidenciais, portanto, devem ser seguidos protocolos de segurança rigorosos. Para importar dados de cartão para o Yuno a partir de um gateway existente, conclua as etapas a seguir:

  1. Coordenar com o gateway atual: Entre em contato com o cofre ou gateway de terceiros atual e solicite uma exportação dos dados do método de pagamento. Certifique-se de seguir os protocolos especificados.
  2. Preencher a solicitação formal: Envie uma solicitação formal à Yuno, garantindo que todos os detalhes e processos necessários sejam documentados. O tempo de resposta e os procedimentos do gateway determinarão o processo de transferência de dados.
🚧

Suas responsabilidades ao migrar tokens

Você é responsável por gerenciar a comunicação com seu provedor gateway durante todo o processo de migração. A equipe da Yuno dará suporte e colaborará diretamente com o gateway de terceiros para facilitar o processo de importação. Além disso, as informações de assinatura do cliente, incluindo valores, datas, etc., devem ser obtidas diretamente da entidade exportadora, pois a Yuno não extrairá esses dados de arquivos criptografados.

📘

Segurança na transferência de dados

Todos os dados durante o processo de migração são criptografados usando chaves PGP e transferidos usando SFTP (Secure File Transfer Protocol).

Requisitos do lado do cliente (etapa 3)

Para concluir com êxito o processo de migração token , é essencial atender aos requisitos do lado do cliente descritos na etapa 3. Isso envolve o fornecimento dos dados necessários do usuário, incluindo os compradores e seus métodos de pagamento existentes.

Você pode executar o processo de migração token usando a API Yuno, que foi projetada especificamente para comerciantes. Como comerciante, você usará essa API para:

  1. Adicionar clientes: Registre clientes no sistema Yuno.
  2. Registrar métodos de pagamento: Registre os métodos de pagamento obtidos dos processadores de pagamento para cada cliente no sistema Yuno.
📘

Opção de migração de API

A opção de migração de API permite que os comerciantes gerenciem seus clientes e seus respectivos dados de pagamento. Saiba mais sobre o assunto

Para obter um guia detalhado sobre como realizar a migração de token usando a API, clique no botão abaixo:

Formato de dados

A Yuno especifica os parâmetros necessários para cada cliente e cartão de crédito para prosseguir com o processo de migração. Os parâmetros necessários estão listados abaixo:

  • ID da conta
  • ID do cliente do comerciante
  • Primeiro nome
  • Sobrenome
  • Email
  • País
  • Número do documento
  • Tipo de documento
  • Tipo de método de pagamento
  • ID do método de pagamento
  • token do método de pagamento

Consulte o objeto Customer e o objeto Payment Method para explorar todos os parâmetros possíveis para importar/criar clientes ou registrar objetos de pagamento.

Limitações técnicas associadas a métodos de pagamento alternativos podem torná-los inelegíveis para migração entre provedores de serviços. Se estiver pensando em migrar tokens de métodos de pagamento alternativos, como Mercado Pago Wallet Connect ou Bancolombia Tokenbox, para o cofre da Yuno, entre em contato com a equipe de suporte da Yuno.

Validação de dados

Para garantir um processamento eficiente e evitar atrasos durante o processo de migração token , forneça as seguintes informações ao se comunicar com o Suporte da Yuno:

  • O nome do identificador externo que será usado para a importação.
  • Uma contagem aproximada do número esperado de métodos de pagamento a serem incluídos (uma estimativa aproximada é aceitável).
  • Quaisquer lacunas de dados conhecidas, como nomes ou datas de validade ausentes.
🚧

Aviso importante

A Yuno não valida as datas de vencimento durante a importação do cartão de crédito.

Proteção de dados

Ao processar pagamentos por meio do Yuno, a plataforma se conecta aos processadores de pagamento. O Yuno tokeniza e criptografa os dados para garantir a segurança, simplificando o processo de conformidade com o PCI. No entanto, você é responsável por gerenciar e proteger os dados do seu cliente. Além disso, você deve comunicar quaisquer taxas ou problemas adicionais ao seu cliente.

Requisitos Gateway e do provedor de pagamento

Para prosseguir com o processo de migração, você precisará fornecer o seguinte:

  • Uma chave SSH pública (você pode fornecer uma para produção e outra para teste). Use o seguinte comando para gerá-la: ssh-keygen -t rsa -b 4096 -C [email protected]
  • Os IPs de saída que serão usados durante a migração.
  • Um arquivo de modelo dos dados a serem migrados para entender sua estrutura. Ele deve incluir os seguintes dados obrigatórios:
    • Nome do titular do cartão: o nome completo do titular do cartão, conforme armazenado pelo provedor atual.
    • Data de expiração: A data de expiração do cartão.
    • Número do cartão: O número completo do cartão (PAN) que será tokenizado pela Yuno.
    • ID do cartão: um identificador exclusivo atribuído a cada cartão pelo provedor atual, usado pelo cliente para fazer referência a esse cartão durante as transações.

Chave pública PGP

Use nossa chave pública para criptografar os arquivos sensíveis à PCI que você envia para a Yuno.

Email: email protected]

Comentário: Para criptografar dados confidenciais. Ambiente: produção

Criado: 22 Nov 2024

Expira: 22 de novembro de 2026

Key ID: 73D3D88A

Comprimento: 4096

Algoritmo: RSA

Fingerprint: 5160 7134 4C00 D270 93FB C450 19ED AACD 73D3 D88A


Chave de produção
-----BEGIN PGP PUBLIC KEY BLOCK-----

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
sNugHSYrj1RUuA==
=ik2s
-----END PGP PUBLIC KEY BLOCK-----