Utilizando condicionais

Documentation Index

Fetch the complete documentation index at: https://docs.malga.io/llms.txt

Use this file to discover all available pages before exploring further.

Através do fluxo inteligente, é possível adicionar regras condicionais para o processamento das cobranças. Os condicionais podem utilizar dados das cobranças, como o valor, parcelas, bandeira do cartão selecionado, ou metadados enviados no campo metadata das charges. Através do botão :heavy_plus_sign: nas ramificações do fluxo, é possível adicionar novos condicionais, utilizando do menu na lateral direita, conforme imagem:

​

Menu para adição de condicionais

Confira os parâmetros de condicional disponíveis para inserir no fluxo de pagamentos:

• Balanceador de Distribuição de carga
• Bandeira do cartão
• Campo personalizado (parâmetro de metadata enviado na cobrança)
• Moeda
• Número do cartão
• Parcelas
• Valor
• Combinações (diferentes condicionais no mesmo card)

​

Como configurar cada tipo de condicional

​

1. Balanceador de Distribuição de carga

Conceito: Divide o processamento das transações de forma randômica entre duas ramificações, considerando os valores % estabelecidos na configuração (exemplo 40% ramificação 1, 60% ramificação 2); Como utilizar:

• A soma dos valores deve somar 100% da carga
• Aceita até duas ramificações para divisão da carga
• Devem ser adicionados provedores após o condicional para processar cada carga estabelecida
• Podem ser adicionados condicionais após o balanceador
• Não podem ser inseridos valores negativos na distribuição da carga (exemplo - 10%)

​

Configuração do condicional de Balanceador, indicando a distribuição de carga

​

Card de distribuição de carga

​

2. Bandeira do cartão

Conceito: Utiliza a bandeira do cartão [brand] como condicional para o processamento da transação. Como utilizar:

• Operadores: Igual a / Diferente de
• Selecionar o operador e a bandeira da condicional

​

Configuração

​

Adição

​

3. Campo personalizado [metadata]

Conceito: Utiliza a informação de metadata enviada na cobrança [paymentFlow.metadata.*] para uso como condicional para o processamento da transação; Como utilizar:

• Indicar o nome do atributo (exatamente igual a paymentFlow.metadata.nome_do_atributo enviada na cobrança);
• Indicar o operador que quer utilizar na condicional, conforme o tipo de atributo:
  • Número [number] - operadores: menor/maior que, menor ou igual/maior ou igual a, igual a/diferente de;
  • Booleano [boolean] - operadores: true/false;
  • Texto [string] - operadores: igual a/diferente de.
• Indicar em qual ramificação o fluxo deve seguir caso a informação de metadata não seja enviada na cobrança, se o fluxo seguirá o caminho do condicional “Verdadeiro” ou “Falso”

​

Tipo número - Configuração

​

Tipo número - Adição

​

Tipo texto - Configuração

​

Tipo texto - Adição

​

Tipo booleano - Configuração

​

Tipo booleano - Adição

​

4. Moeda

Conceito: Utilizar a moeda da cobrança [currency] como condicional para o processamento da transação. Como utilizar:

• Operadores: Igual a / Diferente de
• Selecionar moeda na listagem

​

Configuração

​

Adição

​

5. Número do cartão

Conceito: Utilizar o número do cartão [cardBin] como condicional para o processamento da transação; Como utilizar:

• Operadores: Igual a / Diferente de
• Preencher dado com os seis primeiros dígitos do cartão.

​

Configuração

​

Adição

​

6. Parcelas

Conceito: Utilizar o número da parcelas da cobrança [installments] como condicional para o processamento da transação. Como utilizar:

• Operadores: menor/maior que, menor ou igual/maior ou igual a, igual a/diferente de;
• Selecionar quantidade de parcelas até 12 vezes

​

Configuração

​

Adição

​

7. Valor

Conceito: Utilizar o valor da cobrança [amount] como condicional para o processamento da transação; Como utilizar:

• Operadores: menor/maior que, menor ou igual/maior ou igual a, igual a/diferente de;
• Preencher o valor estabelecido como condicional.

​

Configuração

​

Adição

​

8. Combinações

Através do condicional de Combinações, é possível adicionar mais de uma regra condicional em um card do fluxo inteligente, utilizando o conector E/OU para combinar condicionais. Conceito: Utilizar duas ou mais condicionais no mesmo card do fluxo, como regra para processamento da transação; Exemplo de combinação de condicionais: Se a Bandeira do Cartão é “Mastercard” E Parcelas “Maior que 7 vezes” > processar no provedor x; Como utilizar: Podem ser combinados condicionais de diferentes tipos, com limitação de dois condicionais por operação; Não podem ser combinados:

• Balanceador de distribuição de carga não pode ser combinado com outro condicional no mesmo card;
• Provedores de cobrança e antifraude não podem ser combinados, estando sempre em cards independentes;
• Condicionais utilizando o operador = (igual a) e o conector E com a mesma propriedade;
  • Exemplo: bandeira do cartão é igual a (=) MASTERCARD E bandeira do cartão é igual a (=) VISA;
• Condicionais numéricos com operador > (maior) e < (menor) conflitantes; Exemplo: valor da cobrança é maior > que 500 E valor da cobrança é menor < que 100;

​

Operador lógico “OU”

​

Operador lógico “E”

​

Exibição do card combinações

​

Feedback em caso de inserção inválida - Condicionais iguais

​

Combinando condicionais de campo personalizado

Você pode realizar a combinação de mais de um campo personalizado e nesse cenário, deve se atentar que, caso o metadata não seja enviado na transação, o caminho que o fluxo seguirá é o resultado dos valores default que foram combinados. Utilizando o operador lógico OU, o valor que será predominante é o verdadeiro. As combinações possíveis são: Utilizando o operador lógico E, o valor que será predominante é o falso. As combinações possíveis são: