O que é uma orquestração?

Uma orquestração é um fluxo de encaminhamento que decide qual processador trata cada pagamento.

Antes de criar uma orquestração

• Só pode orquestrar processadores de cartão.
• Os processadores devem estar adicionados e ativos em Conexões.

A lista de Orquestrações

Vá a Orquestrações no menu lateral esquerdo. Verá dois separadores: Ativos e Desativadas.

Pode filtrar por tipo de acionador com o menu suspenso Todos os triggers.

As colunas da vista em lista são: ORQUESTRAÇÃO, TRIGGER, CONEXÕES, USO.

Como criar uma orquestração?

• Vá a Orquestrações e clique em «Criar orquestração».
• O editor de canvas abre. Insira o nome da orquestração no campo superior.
• Escolha o acionador desta orquestração.
• Construa o fluxo adicionando blocos a partir do canvas.
• Quando terminar, clique em Publicar para que as alterações entrem em vigor.

O canvas: como funciona

O editor de orquestrações é um canvas visual. No cabeçalho do editor encontrará:

• Toggle de ativação da orquestração.
• Data e hora da última atualização (Atualizado: [data]).
• Nome da orquestração (editável).
• Contador de utilização.
• Botões Desfazer e Refazer.
• Botão Publicar.

Acionadores

Ao criar uma orquestração, escolhe primeiro o acionador:

• Primeiro pagamento: pagamentos iniciados pelo utilizador no checkout.
• Pagamento recorrente: cobranças recorrentes de assinaturas.
• Pagamento físico: pagamentos efetuados num terminal físico (POS).

Blocos

Existem dois tipos: blocos utilitários (organizam o fluxo) e blocos de ação (executam algo no pagamento).

Blocos utilitários:

• Rota: divide o fluxo em ramos com base em condições.
• Dividir tráfego: distribui o tráfego entre ramos em percentagens configuráveis.

Blocos de ação:

• Concluir pagamento: envia o pagamento a um processador.
• Executar 3DS: lança a autenticação 3D Secure independentemente do processador.
• Criar Network Token: tokeniza o cartão com o esquema de rede antes do processamento.

O bloco Rota

O bloco Rota funciona como um switch/case: cada Condição adicionada é um ramo de saída independente com o seu próprio fluxo. Existe sempre um ramo por defeito «Todos os demais» que é executado quando nenhuma condição é satisfeita.

Variáveis disponíveis numa Condição de Rota (33 no total)

Operação (12): Preço, Moeda, Tipo, Idioma, Apenas autorizar, MOTO, Aprovação parcial, POS, Terminal POS, Pontuação de fraude, Autorizações recorrentes, Subscrições recorrentes.

Cliente (9): Variável personalizada, Tipo de dispositivo, Sistema operativo, Browser, País IP, Região IP, País, Região, E-mail.

Cartão (12): Marca, Tipo, Nível, País de emissão, Banco emissor, Carteira utilizada, BIN, Network Token, Tentativa Network Token, Titular, Mês de expiração, Ano de expiração.

Actualizado em: 12/05/2026