Preciso publicar um fluxo para começar?

Não. Com uma única conta habilitada no ambiente, o Minstrel usa essa conta. O fluxo passa a ser necessário quando existe mais de uma conta e você quer decidir a ordem, o peso ou as condições.

O que acontece com as transações em andamento quando eu publico?

Nada. A versão publicada vale para as transações seguintes; as que já estavam no meio da execução seguem na versão em que começaram. A versão anterior continua guardada e pode ser publicada de novo.

Dá para testar sem gastar uma transação de verdade?

Dá. O simulador não grava nada e não aciona nenhum parceiro, e o sandbox é gratuito e ilimitado. No sandbox você ainda escolhe o resultado de cada cartão de teste: aprovação, recusa por saldo, cartão perdido ou exigência de 3DS.

Orquestração

Você desenha o caminho de cada venda

Arraste as etapas, defina as condições e publique. O fluxo passa a valer na próxima transação, sem esperar deploy e sem alguém do time mexer em código.

Quatro estratégias de rota
Fallback por tipo de falha
Simule antes de publicar

Testar no sandbox Documentação de fluxos

Como funciona

1
Conecte as contas
Cada adquirente, banco ou antifraude vira uma conta de plugin, com as credenciais testadas no parceiro antes de serem gravadas.
2
Desenhe o fluxo
Gatilho, condições, antifraude, rota, split e retentativa são blocos. Cada saída precisa de destino, inclusive a de erro.
3
Simule com dados reais
A simulação percorre o grafo e explica cada decisão em português. Nada é gravado e nenhum parceiro é acionado.
4
Publique
A versão publicada é imutável e substitui a anterior do mesmo gatilho. Voltar atrás é publicar a versão antiga de novo.

No painel

O construtor

Blocos de gatilho, condição, antifraude, rota e fim, com as saídas nomeadas. A barra lateral edita o nó selecionado, e a rota por peso distribui o volume entre as contas.

Construtor de fluxos: rota por peso entre duas adquirentes, com antifraude antes.

No painel

A simulação

Antes de publicar, informe um valor, uma bandeira e uma nota de risco. A simulação devolve o caminho que a transação tomaria, nó a nó, com o motivo de cada decisão.

Simulação de um fluxo: cada passo traz a saída tomada e a explicação da decisão.

O que está incluído

Quatro estratégias de rota
Por ordem de prioridade, sorteando pelo peso de cada conta, pelo custo cadastrado ou alternando igualmente entre as contas.
priority · weighted · least_cost · round_robin
Fallback que distingue queda de recusa
Uma chave para falha técnica do parceiro e outra para recusa reversível. Recusa irreversível sempre interrompe o fallback, independentemente da configuração: insistir nela é pagar por tentativa que o emissor já disse que não aprova.
fallbackOnConnectorFailure · fallbackOnReversibleDecline
Regras são dados, nunca código
As condições usam um catálogo fechado de campos: valor, parcelas, bandeira, BIN, tipo de cartão, país, etiquetas do cliente, nota de risco, número da tentativa e o motivo da recusa anterior. Não existe operador de regex, de propósito: regex do usuário no caminho de autorização é vetor de negação de serviço.
payment.amount · card.brand · risk.score · attempt.number
Ciclo é proibido por desenho
O grafo é acíclico porque um laço no caminho de autorização giraria enquanto o comprador espera. Repetir a cobrança em outra data é o nó de retentativa, que agenda em vez de voltar no grafo.
A publicação valida em três camadas
O schema de cada nó, o grafo inteiro (um gatilho, nenhum ciclo, nenhuma saída solta) e as referências: toda conta e todo recebedor existem, estão no mesmo ambiente e habilitados. Cada problema volta com o nó e o campo.
POST /v1/flows/validate
Trilha de cada execução
O detalhe da transação mostra por quais nós ela passou, qual saída tomou e por quê, com a explicação escrita em português.

Resposta da simulação

{  "outcome": "aprovado",  "path": [    { "nodeId": "trigger", "explanation": "Gatilho: payment.authorization_requested." },    { "nodeId": "faixas", "handle": "alto",      "explanation": "Caso \"Acima de R$ 10.000,00\": payment.amount (1500000) maior que 1000000" },    { "nodeId": "antifraude", "handle": "approve",      "explanation": "Score simulado 20 resultaria em approve." },    { "nodeId": "rota-alto", "handle": "approved",      "explanation": "Rotearia para ca_adquirente_y (estrategia priority)." }  ]}

Documentação de fluxos

Cartão salvo não troca de adquirente

O token de um cartão é emitido por uma adquirente e só vale nela. Por isso o cartão salvo vai sempre para a conta onde foi cadastrado, e o fallback entre contas vale para Pix, boleto e para o cartão com token de bandeira aceito por mais de uma conta. Quando a rota não tem a conta de origem, o pagamento falha com o motivo explícito no rastro.

Dúvidas frequentes

O detalhe técnico de cada resposta está na documentação de fluxos.

Preciso publicar um fluxo para começar?
Não. Com uma única conta habilitada no ambiente, o Minstrel usa essa conta. O fluxo passa a ser necessário quando existe mais de uma conta e você quer decidir a ordem, o peso ou as condições.
O que acontece com as transações em andamento quando eu publico?
Nada. A versão publicada vale para as transações seguintes; as que já estavam no meio da execução seguem na versão em que começaram. A versão anterior continua guardada e pode ser publicada de novo.
Dá para testar sem gastar uma transação de verdade?
Dá. O simulador não grava nada e não aciona nenhum parceiro, e o sandbox é gratuito e ilimitado. No sandbox você ainda escolhe o resultado de cada cartão de teste: aprovação, recusa por saldo, cartão perdido ou exigência de 3DS.

Continua em

Veja funcionando no sandbox

Gratuito, ilimitado e sem prazo. Dá para simular aprovação, cada recusa da ABECS e falha de rede antes de credenciar a primeira adquirente.

Primeiros passos Ver preços