Gateway de teste Yuno

Para testar pagamentos com cartão em geral, a Yuno fornece o Yuno Test Payment Gateway. Ele funciona como uma conexão, no entanto, está disponível apenas no ambiente sandbox.

Conectando-se com a Yuno

Informações gerais

Países:

Disponível em todos os países.

Moedas:

Todas as moedas estão disponíveis.

Tipo de cartões:

Crédito, débito e pré-pago.

Dados de teste:

Informações do cartão para concluir pagamentos no modo de teste.

Configuração da integração

Ambiente de produção

Configurar o Gateway de pagamento de teste da Yuno

1. Conclua aconfiguração da Integração do Gateway de pagamento de teste.
2. Depois de estabelecer a conexão, você deve designar o Yuno Test Payment Gateway como seu provedor de pagamento com cartão na sua seção de roteamento. Acesse Roteamento no Painel de Controle do Yuno, selecione Não publicado, localize a opção Cartão e clique em Configurar.

3. Criar uma nova rota para Cartão. Se você não tiver certeza de como criá-lo, verifique a seção Configurar o roteamento dinâmico.
   1. No painel Roteamento, adicione condições para acionar o pagamento com cartão. Você pode usar a marca ou o país do cartão como condições de acionamento, por exemplo.
   2. Para a condição criada, adicione o Gateway de pagamento de teste da Yuno.
   3. Para todas as outras opções de pagamento, selecione a opção Cancelar. A imagem abaixo apresenta um exemplo de configuração de roteamento em que a condição de marca de cartão foi usada, aceitando pagamentos com as marcas Visa e Mastercard.

4. Agora você precisa disponibilizar os cartões para teste. Acesse o construtor de checkout no painel do Yuno. Ative o botão de alternância para Cartão e publique o checkout usando o botão Publicar.

Use o guia Criar pagamento para saber como testar pagamentos com cartão.

Teste pagamentos com cartão com o Yuno Testing Gateway

Nesta página, você encontrará um guia passo a passo sobre como criar um pagamento com cartão usando o Yuno Testing Gateway.

O Yuno Testing Gateway é uma solução da Yuno para testar o pagamento com cartão em geral. Ele funciona como uma conexão. No entanto, ele só está disponível no ambiente sandbox.

Requisitos

Antes de começar a seguir as etapas descritas neste guia, você precisa:

• Acesse seu Credenciais da API no Painel de Controle da Yuno, que são compostos por:
  • public-api-key
  • private-secret-key
  • account_id
• Configure a conexão do Yuno Testing Gateway em sua conta do Yuno Dashboard. Você encontra um guia passo a passo sobre como conectá-lo na seção Configuração de integração.
• Crie uma rota para o Yuno Testing Gateway para defini-lo como seu provedor de pagamento com cartão. Você encontra um guia passo a passo sobre como fazer isso na seção Configurar o Yuno Testing Gateway .
• Configure o construtor de checkout para disponibilizar o Yuno Testing Gateway .

Resumo das etapas

O processo de criação de pagamento normalmente requer a conclusão das quatro etapas listadas abaixo.

1. Criar um cliente
2. Criar uma sessão de checkout
3. Criar um Token único
4. Criar o pagamento

Criar um payment

1. Criar um cliente

Use o Criar o cliente para registrar as informações do cliente. Você precisará fornecer informações pessoais do cliente. Além disso, você também precisará fornecer as merchant_customer_idO nome do cliente é um identificador exclusivo para o cliente usado em seu sistema.

📘

Informações complementares ao cliente

Ao criar um cliente, algumas informações não são obrigatórias, mas podem melhorar a experiência de pagamento do usuário se forem fornecidas. Telefone, endereço de cobrança e endereço de entrega são exemplos de dados não obrigatórios que você pode fornecer. Se você adicionar informações opcionais, esteja ciente dos campos obrigatórios exigidos.

Ao final do processo de criação de um cliente, você receberá uma mensagem idque identifica o usuário no sistema Yuno. Use o id para initialize o checkout.

Se você estiver criando um pagamento para um usuário existente que foi criado anteriormente e já tem um idvocê pode pular esta etapa.

2. Criar uma sessão de checkout

Com um cliente registrado, você pode criar uma sessão de checkout. O checkout é o momento em que o cliente finaliza o pedido e procede ao pagamento dos produtos ou serviços que deseja adquirir. Portanto, nessa etapa, você fornecerá informações sobre o valor do pagamento e o local onde ele está sendo criado.

🚧

Filtragem de condições de rota

Ao criar a rota, você pode definir condições que funcionam como filtros. Se você usou o país como uma condição, verifique se o país fornecido ao criar a sessão de checkout está na lista de condições. Caso contrário, o pagamento com cartão pode não ser processado pelo Yuno Testing Gateway.

Use o Criar sessão de checkout endpoint. Observe que o customer_id necessário para executar a solicitação é o id que você recebeu ao criar o cliente em Etapa 1.

Da resposta da solicitação para o Criar sessão de checkout você receberá o endpoint checkout_session informações. Elas serão usadas para criar o token de uso único (OTT) e o pagamento nas próximas etapas.

3. Criar um token de uso único (OTT)

Um OTT é um identificador exclusivo que a Yuno gera para proteger a privacidade e a segurança de seus clientes. Ele serve como um identificador para detalhes de pagamentos e evita que dados confidenciais sejam armazenados em seus servidores. Portanto, você pode usar OTTs para simplificar a repetição de pagamentos por seus clientes sem a necessidade de reinserir suas informações de pagamento, tornando o processo mais seguro e conveniente.

Você sempre obterá o OTT do Yuno SDK em seu aplicativo de produção. No entanto, para facilitar o teste do processo de criação de pagamento, a Yuno fornece o Criar OTT endpoint. Você precisará fornecer o checkout_session recebido em Etapa 2 e definir o tipo de pagamento como CARD através do type parâmetro. Na resposta, você receberá o parâmetro one-time-tokenque você usará para criar o pagamento.

4. Criar um pagamento

Você criará um pagamento usando o endpoint Create Payment. Abaixo você encontra uma descrição mais detalhada de como criar um pagamento.

4.1 Fornecer os atributos necessários

Fornecer informações relacionadas ao cliente, incluindo checkout_session da Etapa 2 até checkout.session e customer_payer que contém o objeto id da Etapa 1.

Alguns objetos não são obrigatórios ao criar um pagamento. No entanto, se você fornecer essas informações, a experiência de pagamento do usuário será aprimorada. Esteja ciente dos campos obrigatórios se você quiser fornecer essas informações.

4.2 Escolha o tipo de captura

A Yuno oferece duas opções de captura de pagamento:

• Etapa única: A autorização e a captura são realizadas simultaneamente. Você só precisa criar o pagamento. A autorização e a captura são realizadas automaticamente. Para a opção de etapa única, você precisa enviar o capture atributo como true na solicitação.
• Duas etapas: A autorização e a captura são realizadas em momentos diferentes. Depois de criar o pagamento, você precisará executar uma solicitação de autorização e uma solicitação de captura. Se você quiser processar o pagamento em duas etapas, envie capture como false e depois de criar o pagamento, use a opção Autorizar Payment e o Autorização de captura para concluir o processo.

4.3 Definir o fluxo de trabalho de pagamento

Ao criar o pagamento, é necessário informar qual integração da Yuno você está utilizando. Ao criar um pagamento, você deve informá-lo através do workflow que pode ser:

• CHECKOUT: Se você estiver usando o Yuno SDK para criar o pagamento.
• DIRECT: Se você estiver usando uma integração back-to-back. Para usar esse fluxo de trabalho, você precisa estar em conformidade com o PCI.
• REDIRECT: Se você estiver usando uma integração back-to-back e redirecionamento de provedor.

4.4 Forneça as informações sobre o método de pagamento

Informar as informações do método de pagamento por meio do objeto payment_method. Aqui, você fornecerá o one-time-token por meio do atributo token e selecione o pagamento type igual a CARD, o informado em Etapa 3, com base no Lista de tipos de pagamento. Além disso, você precisa adicionar as informações do cartão no objeto detail.card.

Você pode usar a descrição do pagamento ou dados específicos do cartão para obter o resultado desejado ao testar o pagamento com o Yuno Test Payment Gateway. As seções a seguir descrevem em detalhes cada abordagem.

📘

Processo do sistema Yuno

O sistema Yuno segue um processo sequencial, inicialmente examinando os dados do cartão e, posteriormente, avaliando a descrição fornecida. Consequentemente, se houver uma disparidade entre o status indicado pelos dados do cartão e a descrição de um pagamento de teste, o Yuno priorizará e refletirá o status associado aos dados do cartão.

4.4.1 - Descrição do pagamento

Para obter o resultado de pagamento desejado usando a descrição do pagamento, você precisa definir o resultado esperado como a descrição do pagamento que você criou. Por exemplo, se estiver testando um pagamento e esperar um resultadoSUCCEEDED, a descrição do pagamento deverá serSUCCEEDED". Você encontrará todas as opções disponíveis na seção Códigos de transação.

4.4.2 - Detalhes do cartão

Outra opção para obter os resultados de pagamento esperados é usar um dos cartões de teste fornecidos pela Yuno. Nas tabelas abaixo, você encontra uma lista de cartões e seus detalhes de dados para usar ao utilizar o Yuno Testing Gateway. A coluna Código de resposta da transação define o status do pagamento retornado quando você usa o cartão correspondente.

4.4.3 - Cartões de teste 3DS

Use esses cartões e códigos OTP para testar fluxos 3DS em nosso ambiente de visualização usando um Simulador Netcetera Demo Merchant (NDM), que é configurado para simular um Servidor de Diretório e/ou ACS com esquemas predefinidos e números de cartões de teste. Ele não alcança o DS/ACS de teste externo, apenas ajuda a completar os fluxos 3DS para fins de teste.

5. Verificar o status do pagamento

Após realizar a solicitação ao Criar PaymentSe você não tiver uma conta, poderá verificar o status do pagamento analisando o status e sub_status da resposta. Verifique o Status Payment para ver todas as opções que você pode receber em resposta à solicitação de criação de pagamento.

Dependendo do processador e do método de pagamento, o status pode levar algum tempo para ser atualizado. Portanto, talvez você precise usar endpoints para recuperar o status do pagamento. Para executar essa tarefa, você pode usar endpoints Retrieve Payment by ID ou Retrieve Payment by merchant_order_id. Outra opção é usar webhooks para receber notificações após cada evento. A Yuno recomenda que você use webhooks para monitorar melhor os pagamentos assíncronos. Consulte o guia Webhooks para saber como configurar a solução de webhooks fornecida pela Yuno.