Visão Geral

Bem-vindo à integração de pagamentos da nossa plataforma!

Este documento fornece uma visão geral do fluxo de pagamento para que você possa compreender como funciona o processo de pagamento integrado entre a nossa plataforma e a sua aplicação.

Fluxo de Pagamento Resumido

1. Seleção da Forma de Pagamento no Checkout:
   • O usuário final seleciona a forma de pagamento desejada durante o checkout na sua aplicação.
2. Disparo do Payload URL/Payment-Detail:
   • Nesse momento, a plataforma envia um payload para a URL especificada pelo parceiro, onde será devolvido o HTML necessário para que o usuário final preencha os dados de pagamento.
3. Confirmação do Pedido pelo Usuário Final:
   • O usuário final confirma o pedido clicando no botão "Fechar Pedido".
4. Tokenização dos Dados de Pagamento pelo Parceiro:
   • O parceiro deve criar um script que tokeniza os dados de pagamento ainda no frontend da página e retorna uma hash identificando esses dados.
5. Processamento do Pagamento:
   • Dependendo se o fluxo utiliza AntiFraude ou não:
     • Com AntiFraude:
       • A plataforma aguarda a resposta da autorização e, se aprovada, envia o paylod para captura do pagamento pelo Parceiro.
     • Sem AntiFraude:
       • A plataforma marca o pedido como "Pago" após receber a confirmação de pagamento do parceiro.
6. Retornar dados na página de confirmação:
   • O parceiro cria a estrutura na pagina de confirmação com script’s na plataforma para expor os dados necessários sobre o pagamento, por exemplo boleto QRCodePIX.

Este resumo fornece uma visão geral do processo de pagamento integrado. Recomendamos que você consulte o diagrama detalhado abaixo para uma compreensão mais aprofundada de cada etapa do processo.

Funcionalidades do Conector de Pagamento Customizado

📘

Importante

As funcionalidades listadas abaixo podem ser utilizadas separadamente e a plataforma irá substituir o padrão pelo que está sendo enviado no response.

Ou seja, é possível utilizar somente a funcionalidade Cartões Salvos e as demais retornar vazio ou "null", utilizando assim o padrão da plataforma.

Cartões Salvos

Permite apresentar uma lista de cartões já utilizados e salvos pelo consumidor para facilitar o fechamento do pedido, tornando-se desnecessário um novo preenchimento das informações do cartão do consumidor.
Essa informação será retornada no Response do payload Payment Details.

É necessário desenvolver no front-end da loja a opção do consumidor salvar o cartão para utilizar nas próximas compras. Essa opção deve estar dentro do formulário de "Novo Cartão de Crédito".
A plataforma irá enviar na Requisição de Payment, dentro do objeto "Pagamento > Form" o campo "saveCard" como "true" quando o consumidor selecionar a opção, ou "false" quando o consumidor não selecionar.

É necessário desenvolver no front-end e na integração também a funcionalidade de deletar o cartão salvo pelo usuário.
O consumidor poderá excluir o cartão salvo e a plataforma irá enviar uma requisição para a URL cadastrada informando a exclusão. Mais detalhes em Modelo de Requisição Card.

Scripts Customizados

Permite inserir scripts no módulo de pagamento, no momento que a opção de pagamento customizado é selecionada pelo consumidor.
Para mais detalhes técnicos, acesse Modelo de Requisição Payment Details.

HTML do Formulário Customizado

Diferente do campo "Editor HTML" que permite apenas inserir mais campos no formulário, essa funcionalidade permite substituir nosso formulário padrão por outro formulário em formato HTML com mais informações e layout customizado. Essas informações serão enviadas na requisição para a URL informada. Para mais detalhes técnicos, acesse Modelo de Requisição Payment Details.

Parcelamento Customizado

Permite mostrar parcelamentos diferenciados para grupos de clientes, baseado no retorno da chamada feita pela plataforma. Ou seja, a plataforma faz uma requisição na URL informando os dados do pedido, e o endpoint retorna a quantidade de parcelas disponíveis para este pedido. Para mais detalhes técnicos, acesse Modelo de Requisição Payment Details.

Segue abaixo uma tabela de exemplo onde separamos os CPFs/CNPJs dos clientes em Grupos A, B, C e D, onde o Grupo A é composto por clientes Premium, com mais vantagens, mais compras, ou qualquer outro critério adotado:

Grupo	Parcelas disponíveis
Grupo A	12x sem juros
Grupo B	8x sem juros
Grupo C	4x sem juros
Grupo D	2x sem juros
Grupo A	12x sem juros

🚧

Importante

Os Parcelamentos e os Juros devem ser os mesmos configurados no Admin > Pagamentos > Grupos e Parcelamentos > Parcelamentos.

Two Steps

No processamento "two-steps", a Autorização é feita separada da Captura do pagamento no cartão. Esse fluxo permite que o lojista utilize qualquer solução de Antifraude disponível no mercado, bem como criar seu próprio fluxo interno de análise de risco. Saiba mais acessando a documentação do Antifraude Personalizado.