Retentativas de cobrança entre gateways
Entenda como o Plasma escolhe o gateway, quando tenta de novo, quando passa para o próximo e quando para, e monte a sua cadeia de cobrança.
Como o Plasma escolhe o gateway
Toda cobrança segue a mesma ordem, a cadeia de cobrança:
- O titular do método faz a primeira tentativa. É o gateway com o switch do método ligado (Pix, cartão ou boleto) na tela dele, em Gateway.
- Se o titular falhar, o Plasma percorre a lista de Retentativas, de cima para baixo. A lista tem até três gateways.
- Os gateways da lista processam qualquer método que aceitem, mesmo com o switch desligado. O switch só decide o que aparece no checkout e quem é o titular.
Um exemplo: a BlackCat é titular de Pix, e a lista de retentativas é IronPay e depois Asaas. Um Pix tenta a BlackCat, depois a IronPay, depois o Asaas.
Sem lista salva, não há retentativa: só o titular tenta. A cadeia existe apenas quando você monta a lista.
Quando o Plasma passa para o próximo gateway
Nem toda falha merece outro gateway. O Plasma classifica cada falha e decide:
| Tipo de falha | Exemplos | Tenta de novo no mesmo | Passa para o próximo |
|---|---|---|---|
| Instabilidade passageira | rede caiu, tempo esgotado, erro 5xx, limite de requisições | Sim, se configurado | Sim |
| Limitação do gateway | não aceita o método, credencial recusada | Não | Sim |
| Recusa ou dado do comprador | cartão recusado pelo banco, dado inválido | Não | Não |
| Falha não reconhecida | resposta que o Plasma não sabe ler | Não | Não |
Por que a recusa do banco não vai para o próximo gateway. Quem recusa é o banco do comprador, e ele recusa igual em qualquer adquirente. Reapresentar a mesma recusa em três gateways é reapresentação indevida e, em caso de fraude, multiplica a tentativa por todos os adquirentes da loja. Para essa recusa, o caminho é a Sugestão de pagamento, que oferece Pix ou outro cartão na mesma tela.
Por que a falha não reconhecida para. Avançar sem saber o que aconteceu pode cobrar duas vezes, e esse custo é maior que o de perder uma tentativa.
Retentativas no mesmo gateway
Em Retentativas por gateway você escolhe de 1 a 5 tentativas no mesmo gateway antes de saltar para o próximo. Entre uma tentativa e outra o Plasma espera um pouco mais a cada vez (backoff exponencial). Isso só vale para instabilidade passageira; com 1, o Plasma não insiste e salta direto.
Quando o resultado fica incerto
Se o gateway recebe a cobrança e não responde, o Plasma não manda para outro gateway: a primeira cobrança pode ter passado, e mandar adiante arrisca cobrar duas vezes. O pedido fica pendente até o gateway confirmar. Nos gateways que aceitam repetir a mesma cobrança com segurança, o Plasma tenta de novo no mesmo.
Gateway que falha em sequência
Depois de falhas seguidas, o Plasma tira o gateway da frente por alguns instantes e a cadeia começa pelo seguinte. Assim um gateway fora do ar não atrasa cada compra até dar tempo esgotado.
Monte a sua cadeia
Abra as retentativas
No painel, abra Gateway e clique em Retentativas, no topo da tela.
Confira o titular
O primeiro passo da cadeia mostra o Titular do método de Pix, cartão e boleto. Para trocar, mude o switch do método na tela do gateway.
Escolha a ordem
Preencha as posições de retentativa com os gateways que vêm depois do titular. A cadeia para no primeiro espaço vazio. Escolha Nenhum para encerrar a lista ali.
Ajuste e salve
Defina as Retentativas por gateway e clique em Salvar Prioridades.
Upsell de um clique no cartão
A segunda compra do upsell no cartão fica sempre no gateway da compra original, porque o cartão guardado só vale lá. O upsell em Pix segue a cadeia normal.