Opções Avançadas de Pix
- Daniel Mazeto Piccoli
- Milena Costa Daré
1 Introdução - Chamada de API
As opções e processos descritos neste documento não são válidos quando o QRCode é proveniente da própria Integração ERP. Nesse caso, nenhuma transação será realizada e a responsabilidade pela baixa do boleto é da própria integração. Nessa situação, ainda não existe a possibilidade de realizar a consulta do status de pagamento do PIX e enviar feedback em tempo real no totem e/ou site.
Para melhor entendimento sobre as Opções Avançadas de PIX, é fundamental termos conhecimento sobre o fluxo de criação das Transações PIX:
Ao realizar a chamada da API de criação de PIX, o primeiro passo é verificar se já existe um PIX válido e não expirado para aquele boleto. Se houver, ele será retornado.
O PIX gerado pela Datacake possui validade de 1 hora. Portanto, é considerado como PIX válido aquele que ainda possui 30 minutos restantes.
Não existindo transação válida, partimos para o passo de seleção do Método PIX a ser utilizado, que será descrito nos próximos itens.
2 Único Método Ativo
Para que seja possível realizar uma Transação PIX é necessário que haja pelo menos um método configurado e ativo, caso contrário a API retornará uma Bad Request.
Esta configuração é suficiente para o bom funcionamento nos casos em que os recebimentos sejam todos na mesma carteira de cobrança, ou quando apenas uma Integração ERP estiver ativa, não sendo necessário realizar configurações adicionais.
Todavia, em caso de múltiplas carteiras de cobrança ou múltiplas Integrações ERP, os passos seguintes deverão ser observados:
Para mais informações sobre Métodos PIX, consulte https://myog.atlassian.net/wiki/spaces/ISP/pages/1670807553, ou time de Suporte Datacake.
3 Múltiplas Integrações ERP - Método PIX Fallback
Cada Integração pode possuir seu próprio Método PIX padrão. Esta configuração é útil quando múltiplas integrações são utilizadas simultaneamente. Assim, após o passo de verificação de Método PIX ativo durante a criação da transação, caso exista um Método PIX Fallback para a Integração ERP e o mesmo estiver ativo, substituirá, então, o método anterior.
4 Múltiplas Carteiras de Cobrança - Identificador do Boleto
Nos casos em a mesma Integração ERP é responsável por múltiplas filiais ou carteiras de cobrança e, para cada uma destas, um Método PIX for criado, é necessário vincular um Identificador no Boleto ao seu respectivo Método PIX.
Ao adicionar um novo relacionamento, a seguinte tela será aberta:
Identificador no Boleto deverá ser preenchido conforme informações do ERP;
Integração deverá vir preenchida com a própria integração originária. Integração deve ter sido salva previamente;
Método PIX a ser relacionado ao Identificador no Boleto;
Havendo uma correspondência entre o Método PIX e o Identificador, e estando este método ativado, ele substituirá o método selecionado nos passos anteriores.
5 Conclusão
Após os passos 2, 3 e 4, é realizada, de fato, a criação da transação. Se houver algum erro durante o processo a API irá retornar uma Bad Request. Em caso de sucesso, retornará um modelo de transação contendo o QRCode.