Skip to main content


As companies grow, the structure of digital payments also grows and becomes more complex. In many business models, the use of multiple providers needs to be done strategically to optimize the approval of collections with specific characteristics, as well as operating costs.

Intelligent Flows provide Conditional Operators that can be configured to change the way your charges are processed, such as modifying provider priorities or activating an anti-fraud provider to improve security at the time of processing. With this functionality, here at Malga, the charges follow the path defined in the Smart Flow linked to the merchant and payment method being used.

Unique paths within a Smart Flow are called branches. At the moment, each payment method can have up to one active Smart Flow with up to one anti-fraud provider and up to three billing providers per branch.

Conditional Operators

Conditional pperators are flow separators that can be configured using logical comparators in conjunction with data available in the charges to decide which providers will be used to process that charge. Conditionals can use native data from the charges, such as the amount, number of installments and the selected card brand or metadata sent in the metadata field of the charges.

Table of Supported Operators

Logical Operator OR

OperadorDescriçãoTipo dos OperandosExemplo de Expressão
lt (<)Less thannumbertransaction.amount < 5000
gt (>)More thannumbertransaction.amount > 5000
le (<=)Less or equal tonumbertransaction.amount <= 5000
ge (>=)More of equal tonumbertransaction.amount >= 5000
eq (=)Equal tonumber, stringtransaction.installments = 0
ne (!=)Different fromnumber, stringtransaction.installments != 0
andLogical operator ANDbooleantransaction.installments = 0 and transaction.amount < 5000
orLogical operator ORbooleantransaction.installments = 0 or transaction.amount < 5000

Available Charge Properties

Charge properties can be used to compose charges processing rules alongside Conditional Operators. The properties currently mapped for use in processing rules are in the following table.

amountnumberAmount of charge in cents
currencystringCurrency identifier for charge processing, ISO 4217 format
cardBinstringThe first six digits of a card, known as the Bank Identification Number or Issuer Identification Number
brandstringCard brand (unique for cards)
installmentsnumberNumber of installments to be charged (unique for credit type transactions)
metadata-PProperty for inserting additional fields in the charge. Properties of type number, number, string, boolean or object can be added

Using transaction metadata

It is possible to send metadata from the charge for use in your Smart Flows. This property is a special property of the charge that accepts any properties within it, enabling you to process business rules by choosing which providers should process that transaction using the Malga engine.

"paymentFlow": {
"metadata": {
"stringProperty": "value for property 1",
"numericProperty": 10,
"numericProperty2": 10.5,
"listProperty": ["element1", "element2"],
"objectProperty": {
"subProp1": "value"

Example of Metadata usage

The additional data of the charges are extremely flexible and serve to allow you to process your business rules using Malga's internal engine. For example, if you want to use properties that do not normally exist in a Malga charge, you can add these properties using the metadata field, as shown in the following example:

Smart Flow Example

In this scenario if the value of metadata.daysToEvent is greater than 60 no anti-fraud providers are used to protect the charge. As well as sending the arbitrary daysToEvent property, any property can be sent with a charge to process conditional rules.

ChargeAntifraudProvider 1Provider 2Provider 3
daysToEvent = 61; amount = 550; installments = 2-PagSeguro 2PagSeguro 3Adyen
daysToEvent = 45; amount = 300; installments = 6Clearsale 2PagSeguro 1PagSeguro 3Adyen
daysToEvent = 70; amount = 1200; installments = 3Clearsale 1PagSeguro 2PagSeguro 3Adyen

Although it is possible to send metadata by passing a list of elements or objects nested in metadata for processing, there are still no operators compatible with these types of properties.

Charge Distribution

It is possible to distribute charges in branches of the Intelligent Flow using the math/random property. This property generates a random number between 0 and 1 and can be accessed in conjunction with logical operators to create load distribution rules, as in the following example, where 60% of transactions are sent by the true branch and 40% are sent by the false branch:math/random < 0.6

Charge provider 1; Charge provider 2; Charge provider 3; Load balancer

Behavior of Billing Providers

The Charging Providers are configured in a priority order within the Smart Flows. Once a charge is not properly approved at a provider, if the cause of the error allows it to be retried, the charge goes on to be processed at the next provider configured in the Smart Flow. If there is no new provider to try after the last retry error returned, the charge is returned as failed.


Up to three billing providers can be configured in a single branch of your Smart Flow.

Causes of failure can be viwed here.

Behavior of Anti-fraud Providers

In a Smart Flow it is possible to configure Anti-Fraud Providers to protect your transactions and their behavior can be checked in our documentation. Within a single branch of the Smart Flow it is possible to configure only one anti-fraud provider, i.e. it is not possible to process multiple anti-fraud providers for a single charge.

This type of configuration allows you to switch between multiple Anti-Fraud Providers, or even turn off this type of protection, using different strategies for charges of different characteristics. These rules are processed charge by charge according to the characteristics configured in the Smart Flow.


The retry based on anti-fraud providers happens at the pre-authorization stage, so once pre-authorized in a provider the transaction ends its life cycle in this provider until the moment of capture or failure.