Caso de Uso – Pagamento Online no B2B EVO para Veterinários

Histórico de Alterações

Data	Quem	Comentários
28/10/2026	Renato Lima	Criação do documento

Necessidade

A VIRBAC necessita disponibilizar uma experiência de compra digital por meio de uma plataforma B2V (Business-to-Vet), permitindo que o médico veterinário, após realizar seu cadastro, validação e login, possa consultar o catálogo autorizado, visualizar os preços conforme sua classificação comercial, realizar pedidos, efetuar pagamentos e acompanhar o status de faturamento e entrega.

Para o processo de pagamento, o B2B EVO deverá integrar-se à API da Lyra, permitindo o processamento das transações financeiras e a utilização dos meios de pagamento disponibilizados pelo parceiro.

Para pagamentos com cartão de crédito, deverá ser implementada a tokenização, permitindo a reutilização do cartão em compras futuras sem que os dados sensíveis sejam armazenados pelo B2B EVO.

O processo também deverá contemplar Antifraude, com análise das transações antes da autorização definitiva do pagamento.

Além do pagamento, deverá existir controle da jornada financeira da transação, incluindo pagamentos pendentes, novas tentativas, histórico, cancelamentos, reembolsos, aprovações e respectivos status.

O fluxo deverá ainda contemplar o acompanhamento da entrega, utilizando as informações disponibilizadas pela API da AGV, considerando a relação CEP × prazo de entrega definida pela contratante.

Solução

Será desenvolvido no B2B EVO o fluxo integrado de compra e pagamento para veterinários, utilizando a API da Lyra para processamento das transações financeiras e Antifraude.

O fluxo será iniciado após a seleção dos produtos e confirmação do endereço de entrega. O sistema deverá utilizar o CEP do endereço para disponibilizar as informações relacionadas ao prazo de entrega.

Após a definição da forma de pagamento, o sistema encaminhará a transação para o fluxo correspondente:

- Cartão de crédito: verificar existência de token previamente armazenado;

- Novo cartão: realizar o processo de tokenização através da Lyra e armazenar somente o token;

- PIX: encaminhar os dados necessários para processamento da transação;

- Antifraude: submeter a transação à análise antes da autorização definitiva;

- Pagamento aprovado: registrar a transação, atualizar o pedido e prosseguir com o envio ao ERP;

- Pagamento recusado ou pendente: registrar a ocorrência e disponibilizar nova tentativa de pagamento.

A solução também contemplará o controle de cancelamentos e reembolsos diretamente no B2B EVO. As solicitações de reembolso deverão registrar o motivo e passar pela aprovação dos responsáveis do Financeiro e/ou Comercial, antes do envio da solicitação de estorno à Lyra.

O acompanhamento da entrega será realizado por meio de tela específica no B2B EVO, utilizando as informações retornadas pela integração com a API da AGV, parceira logística da VIRBAC.

Implementação

A implementação será composta pelos seguintes componentes:

Fluxo de compra

- Acesso do veterinário ao Portal B2B;

- Seleção dos produtos;

- Confirmação do endereço de entrega;

- Identificação do CEP;

- Consulta das informações de prazo de entrega;

- Confirmação do pedido;

- Seleção da forma de pagamento.

Pagamento

- Integração B2B EVO × API Lyra;

- Processamento de cartão de crédito;

- Processamento de PIX;

- Tokenização de cartão;

- Armazenamento do token;

- Reutilização do cartão tokenizado;

- Registro das transações;

- Tratamento de pagamentos aprovados, recusados e pendentes.

Antifraude

- Envio da transação para análise;

- Recebimento do resultado da análise;

- Tratamento de transação aprovada;

- Tratamento de transação recusada;

- Tratamento de transação direcionada para análise adicional;

- Registro do resultado da análise.

O documento define que o resultado do Antifraude poderá determinar a aprovação, recusa ou encaminhamento da transação para análise adicional, conforme as regras do parceiro.

Controle financeiro

Será criada estrutura específica para gerenciamento das transações, contemplando:

- Pagamentos;

- Análises antifraude;

- Pagamentos pendentes;

- Novas tentativas;

- Cancelamentos;

- Reembolsos;

- Histórico das movimentações;

- Status das transações.

Cancelamento e reembolso

O B2B EVO será responsável por centralizar o controle do processo de cancelamento.

Para pedidos que necessitem de reembolso:

1. Solicitação de reembolso;

2. Registro do motivo;

3. Análise pelo Financeiro e/ou Comercial;

4. Aprovação ou reprovação;

5. Envio da solicitação de estorno à Lyra; 6. Recebimento da confirmação;

7. Atualização do histórico;

8. Atualização dos sistemas envolvidos.

A definição e validação das políticas de cancelamento de pagamento e das políticas de cancelamento/devolução da entrega são de responsabilidade da contratante.

Entrega e logística

Será desenvolvida uma tela para acompanhamento do status da entrega.

As informações serão obtidas através da integração com a API da AGV, permitindo que o B2B EVO apresente as fases de andamento da entrega ao veterinário.

Atores

Ator	Responsabilidade
Veterinário	Realizar cadastro, acessar o B2B EVO, selecionar produtos, realizar pedidos, efetuar pagamentos e acompanhar a entrega.
B2B EVO	Centralizar o fluxo de compra, pagamento, cancelamento, reembolso e acompanhamento da entrega.
Lyra	Processar pagamentos, tokenização e Antifraude por meio de suas APIs.
Financeiro	Analisar e aprovar/reprovar solicitações de reembolso quando aplicável.
Comercial	Analisar e aprovar/reprovar solicitações de reembolso quando aplicável.
ERP VIRBAC	Receber e atualizar as informações relacionadas aos pedidos.
AGV	Disponibilizar informações relacionadas ao andamento da entrega por meio de API.

Pré-condições

- O veterinário deve estar cadastrado e validado.

- O veterinário deve possuir acesso ao B2B EVO.

- O catálogo autorizado deve estar disponível.

- Os preços aplicáveis à classificação comercial do veterinário devem estar configurados.

- O endereço de entrega deve estar cadastrado.

- O CEP do endereço deve estar disponível para utilização no fluxo logístico.

- A integração com a API da Lyra deve estar disponível.

- A integração com o serviço de Antifraude deve estar disponível.

- A integração com a API da AGV deve estar disponível para acompanhamento da entrega.

- As regras de cancelamento e reembolso devem estar definidas e validadas pela VIRBAC.

Escopo

Escopo incluso

- Integração com a API da Lyra;

- Integração com Antifraude;

- Tokenização de cartões;

- Reutilização de cartões tokenizados;

- Pagamento via meios disponibilizados pela Lyra;

- Controle de pagamentos pendentes;

- Nova tentativa de pagamento;

- Histórico das transações;

- Controle de cancelamento;

- Solicitação e aprovação de reembolso;

- Solicitação de estorno;

- Atualização dos status;

- Integração com ERP VIRBAC;

- Integração com API da AGV;

- Tela de acompanhamento da entrega;

- Controle da relação CEP × prazo de entrega.

O documento contratado também prevê estrutura de banco e telas administrativas para acompanhamento das transações financeiras e seus respectivos retornos.

Escopo Não incluso

Com base no documento fornecido, não devem ser considerados neste caso de uso:

- Definição das políticas de cancelamento pela CONTRATADA;

- Definição das políticas de devolução da entrega pela CONTRATADA;

- Desenvolvimento de um novo Gateway de Pagamento;

- Armazenamento dos dados sensíveis dos cartões;

- Criação de serviço próprio de Antifraude;

- Cálculo de valor de frete por CEP.

Ponto de atenção: o fluxograma enviado contém a etapa “Calcular opções e valor do frete”, porém o documento contratual da VIRBAC estabelece expressamente que, neste escopo, o frete será tratado como CEP × prazo de entrega, sem relação de CEP com valor de frete. Portanto, eu recomendaria alterar essa caixa do fluxograma para “Consultar prazo de entrega conforme CEP” para manter o diagrama coerente com o documento contratado.

Documentos Relacionados

Documentação Lyra -Ciclopay Link

Regras de Negócios

[RN1] - Cadastro do veterinário

O veterinário deverá estar previamente cadastrado, validado e autenticado para realizar pedidos.

[RN2] - Catálogo

O veterinário poderá consultar somente o catálogo autorizado para seu perfil.

[RN3] - Preço

Os preços apresentados deverão considerar a classificação comercial do veterinário.

[RN4] - Tokenização

Nos pagamentos com cartão, o B2B EVO deverá armazenar somente o token retornado pela Lyra, não persistindo os dados sensíveis do cartão.

[RN5] - Reutilização do cartão

Quando houver token previamente armazenado, o veterinário poderá reutilizar o cartão sem necessidade de informar novamente seus dados.

[RN6] - Antifraude

A transação deverá passar pelo processo de análise antifraude antes da autorização definitiva do pagamento.

[RN7] - Pagamento recusado

Quando o pagamento for recusado, a transação deverá ser registrada e o veterinário poderá realizar uma nova tentativa sem recriar o pedido.

[RN8] - Pagamento pendente

Pedidos com pagamento pendente deverão permanecer identificados no sistema até que ocorra uma nova tentativa ou atualização do status.

[RN9] - Cancelamento

O controle do cancelamento deverá ser centralizado no B2B EVO.

[RN10] - Reembolso

A solicitação de reembolso deverá registrar o motivo e ser submetida à aprovação dos responsáveis definidos pela VIRBAC.

[RN11] - Estorno

Somente após a aprovação deverá ser enviada a solicitação de estorno à Lyra.

[RN12] - Política de cancelamento

As regras e políticas de cancelamento do pagamento e de cancelamento/devolução da entrega serão definidas e validadas pela VIRBAC.

[RN13] - Frete/Prazo

O fluxo logístico deverá considerar a relação CEP × prazo de entrega, não sendo utilizada, neste escopo, uma relação de CEP com valor de frete.

[RN14] - Acompanhamento da entrega

As informações de andamento da entrega serão obtidas por meio da API da AGV.

[RN15] - Atualização de status

Os status deverão ser atualizados conforme os retornos do Antifraude, Gateway de Pagamentos e ERP. Virbac 8-10 (1)

Regras de Integração

[RI1] - B2B EVO × Lyra

A integração deverá contemplar:

- Envio da solicitação de pagamento;

- Dados necessários para processamento;

- Tokenização;

- Consulta/retorno da transação;

- Retorno do Antifraude;

- Status do pagamento;

- Solicitação de estorno;

- Confirmação do estorno.

[RI2] - B2B EVO × ERP VIRBAC

Deverá contemplar:

- Envio do pedido após confirmação do pagamento;

- Atualização de status;

- Comunicação de cancelamentos;

- Atualizações relacionadas ao ciclo de vida do pedido.

[RI3] - B2B EVO × AGV

A integração deverá disponibilizar as informações necessárias para acompanhamento do andamento da entrega, conforme os dados fornecidos pela API da AGV.

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

GeoSales

Setor	Aprovado Por	Data
Desenvolvimento - GeoSales	Pessoa que aprovou	00/00/0000
Integração - GeoSales	Pessoa que aprovou	00/00/0000
Configurações - GeoSales	Pessoa que aprovou	00/00/0000

Empresa solicitante

Setor	Aprovado Por	Data	Assinatura
Gerente TI - Cliente	Pessoa que aprovou	00/00/0000
Gerente de Projeto - Cliente	Pessoa que aprovou	00/00/0000
Gerente Comercial - Cliente	Pessoa que aprovou	00/00/0000