💡Introdução
A integração com a CIELO é feita na nossa ficha de Inscrições e Matrículas, através de um componente do tipo botão, que será responsável por efetuar a ação de pagamento com cartão. Veja a seguir tudo que você precisa saber para configurá-lo.
Esse guia foi produzido para te ajudar a integrar a CIELO como método de pagamento com cartão na sua ficha de Inscrições e Matrículas.
Antes de começarmos…
- Para que essa integração ocorra com sucesso, é necessário que se tenha em mãos o Merchant ID e a Merchant Key. Você pode conferir como gerar esses dois códigos aqui.
- O seu TOTVS deverá estar integrado com a API da CIELO. Essa etapa caberá à equipe TOTVS, mas você pode encontrar mais informações TOTVS Developer Network (TDN).
👊 Como fazer isso na prática
O primeiro passo é criar um novo componente. Para isso, selecione a aba configurações, vá para componentes e clique em novo componente:
Especifique o tipo botão e confirme clicando em próximo:
Você será encaminhado para a interface de edição do botão que acabou de criar. Aqui você poderá personalizar o texto, visual, ações e lógica da forma como preferir. A integração com a CIELO é uma ação, portanto, na aba Ações, clique em Adicionar ação e selecione integrações.
Em Integrações, clique em Adicionar ação, e selecione CIELO (Checkout transparente):
Você será encaminhado para a tela de configuração da ação.
⚠️ NOTA: Essa parte é muito importante, atente-se aos campos solicitados.
O Merchant ID e o Merchant Key que você gerou, deverão ser inseridos em seus respectivos campos [1 e 2], conforme indicado na imagem abaixo. Além disso, o requerimento na API da CIELO deverá retornar os valores para popular os três campos destacados abaixo.
🚩 DICA: Os campos para receber os dados retornados da API serão campos de texto criados na ficha, será necessário apenas que estejam vinculados à tabela “inscricao”.
A seguir, é preciso relacionar os campos do sistema. ATENÇÃO: O bom funcionamento dessa integração depende do relacionamento correto dos campos, portanto, atente-se ao formato exato esperado pela API da CIELO.
Você pode verificar o formato de todos os valores aqui, ou clicando em Mais informações, como indicado abaixo.
Dos campos listados nessa parte, alguns possuem valores fixos, que devem ser passados em consonância com o formato esperado pelo JSON da API da CIELO.
Verifique esses campos a seguir:
⚠️ NOTA: Os campos listados acima servem para te ajudar a encontrar os valores com mais facilidade, mas não deixe de comparar com o JSON disponibilizado pela CIELO para garantir o pleno funcionamento da integração.
Os demais campos são Campos do sistema, que devem estar criados e configurados para receber seus valores no formato esperado.
Próximos passos
🚩 Você finalizou a configuração geral do seu componente, mas ainda precisamos configurar o processo TOTVS vinculado a ele, que permitirá ao TOTVS receber e lidar com o status de pagamento da forma esperada.
Na aba TOTVS da configuração do seu componente, primeiro vamos parametrizar a consulta que retorna a Data atual. Para isso, clique em Adicionar ação e selecione a opção Realizar consulta:
Coloque uma descrição intuitiva. Em Configuração da consulta, selecione o campo Data atual:
Por padrão, a nossa consulta que retorna a data atual é a RB.PS.IM.023. Configure ela nos campos exibidos abaixo e salve.
De volta a aba TOTVS, clique novamente em Adicionar ação e selecione Executar processo:
Selecione o campo Processo [1], encontre e selecione a opção FinLanBaixaTBCData
🚩DICA: utilize o recurso ctrl+F para encontrar, ou role até o final, por padrão este é o penúltimo processo da lista 😉
Em seguida clique em Adicionar [2] para vincular as colunas do TOTVS com seus respectivos campos e valores:
Ao finalizar toda a configuração e salvar o componente, a ficha de Inscrições e Matrículas irá gerar automaticamente uma URL com todos os parâmetros necessários. Essa URL deverá ser configurada no portal da CIELO, para assim permitir a comunicação da CIELO com a ficha.
✅ Pronto! Com a integração concluída, a ficha já é capaz de receber o status do pagamento.
❓Ficou alguma dúvida?
Entre em contato com o nosso super time de atendimento para obter suporte adicional!
Comentários
0 comentário
Por favor, entre para comentar.