Configure as regras com uma linguagem simples e flexível.
As expressões são compostas por, no mínimo, uma variável, uma operação e um valor. No exemplo abaixo, a expressão será verdadeira se o ID do estabelecimento ($merchant_id) for igual ao valor "XYZ".
$merchant_id == "XYZ"
Variáveis
Todas as variáveis devem começar com $:
| Variável | Conteúdo | Tipo | Exemplo |
|---|---|---|---|
$merchant_id | ID do estabelecimento | Texto | "loja-1234" |
$user_id | ID do usuário | Texto | "cliente-1234" |
$device_ip_address | Endereço IP do dispositivo do usuário | Endereço IP | "200.123.10.2" |
$amount | Valor total do pagamento no formato decimal | Decimal | 100.12 |
$score | Score de risco calculado pela plataforma no formato decimal, variando entre 0.00 e 1.00 | Decimal | 0.75 |
Estamos implementando novas variáveis conforme a necessidade dos nossos clientes. Se desejar priorizar alguma variável, entre em contato.
Operações
Em geral, as seguintes operações são possíveis entre variáveis e valores:
| Operação | Nome |
|---|---|
== | Igualdade |
!= | Desigualdade |
> | Maior que |
< | Menor que |
>= | Maior ou igual que |
<= | Menor ou igual que |
in | Está incluído em |
not in | Não está incluído em |
Os operadores in e not in podem ser usados com listas configuradas no painel de administração e conjuntos (arrays).
Operadores lógicos
É possível conectar mais de uma expressão com os operadores lógicos and e or. Para facilitar a organização, você também pode usar parênteses para agrupar múltiplas expressões.
| Operador lógico | Operação |
|---|---|
and | E |
or | Ou |
Valores
Valores podem ser declarados explicitamente na expressão ou então podem fazer referência a listas previamente cadastradas.
Valores estáticos
Para declarar um valor estático explicitamente na regra, use aspas duplas para valores do tipo Texto e Endereço IP.
$user_id == "cliente-123" and $device_ip_address == "200.123.10.2"
Para valores numéricos, não use aspas:
$amount > 1000.0
Para declarar conjuntos estáticos (arrays), utilize colchetes em conjunto com operadores de inclusão:
$user_id in ["cliente-123", "cliente-456", "cliente-567"]
Como as expressões possuem tamanho limitado, recomendamos usar listas sempre que possível.
Listas
A principal vantagem das listas sobre o conjunto estático é que não é necessário atualizar a regra para incluir ou remover valores. Além disso, com as listas é possível incluir comentários, atribuir prazo de validade para cada registro e consultar o usuário da plataforma que fez o cadastro. Para mais informações, leia o artigo sobre listas.
Para usar listas dinâmicas na expressão, declare o nome precedido por @:
$user_id in @clientes_bloqueados
Além do operador in, também é possível usar not in para a operação reversa.