Pagamentos
Regras e fallback
Escolha a ordem dos gateways e deixe a loja vendendo quando um deles falhar.
Com mais de um gateway conectado, você define qual é tentado primeiro em cada método. Se ele falhar na hora de gerar a cobrança, a plataforma tenta o próximo da lista, sem o comprador perceber.
Definir a ordem#
Conecte os gateways#
Pelo menos dois no mesmo método, com o interruptor ligado. Só gateway conectado e ligado entra nas regras.
Abra Regras de Gateways#
Em Pagamentos, abra a aba Regras de Gateways.
Ordene cada método#
Arraste os gateways de Pix e de cartão na ordem desejada e salve. O primeiro é tentado antes.
Sem regra definida, vale a ordem em que os gateways foram conectados.
Limitar por valor e prazo#
No lápis de cada gateway você define:
- Valor mínimo e máximo: o gateway só recebe pedidos dentro dessa faixa. Fora dela, a venda vai para o próximo da lista.
- Expira em: o tempo que o comprador tem para pagar por esse gateway. O pedido e a reserva do estoque acompanham esse prazo.
No checkout, o comprador só vê as formas de pagamento que aceitam o valor do carrinho, já com as taxas de cada uma. Se nenhum gateway aceitar o valor, a compra fica bloqueada com um aviso.
Como o fallback funciona#
Quando o comprador finaliza a compra, a plataforma percorre a lista do método escolhido:
- Tenta criar a cobrança no primeiro gateway, com limite de 20 segundos.
- Se der certo, a lista para aqui e o comprador recebe o pagamento.
- Se der erro ou passar do tempo, registra a falha no histórico do pedido e tenta o próximo.
- Se nenhum responder, o pedido é cancelado, o estoque é liberado na hora e o comprador vê a mensagem abaixo.
Pagamento indisponível no momento. Tente novamente em instantes.
O que conta como falha#
Qualquer motivo que impeça o gateway de criar a cobrança, incluindo as regras dele:
| Situação | Exemplo |
|---|---|
| Gateway fora do ar ou lento | Sem resposta em 20 segundos |
| Credencial revogada | Chave apagada no painel do gateway |
| Valor abaixo do mínimo | PromissePay abaixo de R$ 0,50 ou SyntraPay abaixo de R$ 1,00 |
| Dado faltando | MisticPay ou AdvinPay sem CPF ou CNPJ do comprador |
Onde ver as falhas#
Cada tentativa que falha fica no histórico do pedido, em Vendas, com o nome do gateway. O status do gateway em Pagamentos mostra se a conexão está com erro.
Monte um bom fallback#
- Tenha ao menos dois gateways de Pix ligados, com contas aprovadas e ativas.
- Coloque primeiro o de menor custo para você.
- Depois de configurar, faça uma compra de teste para cada gateway, mudando a ordem das regras.