| Índice |
|---|
1
...
Introdução - Chamada de API
| Nota |
|---|
As opções e processos descritos neste documento não são válidos quando o QRCode é proveniente da própria Integração ERP. Neste Nesse caso, nenhuma transação será realizada e a responsabilidade pela baixa do boleto é da própria integração. |
Para melhor entendimento do das sobre as Opções Avançadas de PIX, é fundamental termos conhecimento do 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.
| Nota |
|---|
O PIX gerado pela Datacake tem 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.
...
Para que seja possível realizar uma Transação PIX é necessário haver que haja pelo menos um método configurado e ativo, caso contrário a API retornará uma Bad Request.
Esta configuração é o suficiente para o bom funcionamento em caso nos casos em que os recebimentos sejam todos na mesma carteira de cobrança, ou quando apenas uma Integração ERP esteja 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 seguidosobservados:
| Informações |
|---|
Para mais informações a cerca de sobre Métodos PIX, consulte Gateways de Pagamento PIX Bancos, ou o nosso suportetime 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 este 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 janela irá abrirtela 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 o método estando ativo estando este método ativado, ele substituirá o método selecionado nos passos anteriores.
| Nota |
|---|
Consultar o suporte Suporte Datacake para disponibilidade desta função, uma vez que o Identificador do boleto depende do ERP utilizado possui-lo. Deverá ser verificado, também, qual campo é utilizado como identificador em cada ERP. |
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 BadRequest, em Bad Request. Em caso de sucesso, retornará um modelo de transação contendo o QRCode.
...