Como monitorizar transferências a partir de um montante mínimo
Configurar um montante mínimo para um ativo na Monitorização: unidades base, limite inclusivo e verificação com dados artificiais.
Atualizado:
Na Monitorização, pode acompanhar transferências a partir de um montante definido: configure «Quantidade mínima» em «Filtros avançados» para um endereço do projeto selecionado. O limite é um número inteiro nas unidades mínimas do ativo escolhido. A condição é inclusiva: uma transferência de montante igual ao limite cumpre o critério; uma inferior não cumpre.
Comece com um ativo numa única rede. Por exemplo, pode querer monitorizar transferências de entrada de um determinado token para o seu endereço. Esta regra aplica-se ao montante de uma transferência, não ao seu preço em dólares, ao total recebido num dia ou às mensagens de um fornecedor externo.
Prepare o ativo e as unidades
Escolha um projeto com o serviço «Monitorização» disponível, um endereço público e permissão para alterar as suas definições. Confirme que a rede necessária está disponível para monitorização operacional. Adicionar um endereço público não exige uma chave privada nem uma frase de recuperação.
Identifique o ativo exato e o seu número de casas decimais. O nome do token não basta: a rede e o identificador têm de corresponder ao método de monitorização escolhido. Se recebe USDT, não trate redes diferentes ou tokens semelhantes como um único ativo. A escolha é explicada em «Qual é a diferença entre uma rede e um token?».
Converta o montante legível por uma pessoa em unidades base, multiplicando-o por dez elevado ao número de casas decimais do ativo. Não utilize um equivalente arredondado em dólares. Para um ativo com seis casas decimais, um limite de 10 unidades escreve-se como 10000000. É um exemplo de escala, não um limite universal para todas as moedas.
Passo 1. Abra o formulário para adicionar um endereço
Abra «Monitorização», selecione o projeto e a secção de endereços, identificada como «Address». Clique em «Adicionar endereços». No separador «Manualmente», escolha a rede e introduza o endereço público. Aguarde o resultado da verificação do formato; confirme separadamente a titularidade do endereço e se a ligação está pronta.
No bloco de utilização do endereço, selecione «Um ativo». Para a moeda nativa da rede, deixe o campo «Ativo» vazio; para um token, introduza o identificador suportado na rede escolhida. Neste exemplo, mantenha ativa a opção de entradas, «A chegar». Se precisar de saídas, verifique separadamente o seu suporte e a definição do sentido da transferência.
Não escolha todos os ativos logo na primeira regra: o mesmo limite numérico em unidades mínimas diferentes não representa o mesmo montante económico. Configurar um par específico de rede e ativo permite verificar o cálculo sem misturar escalas.
Passo 2. Defina o montante mínimo
Expanda «Filtros avançados». No campo «Quantidade mínima», com a indicação «Unidades de rede base», introduza o inteiro calculado, por exemplo 10000000 para a escala descrita acima. Este valor corresponde ao parâmetro min_amount.
Não introduza aqui uma fração decimal, um símbolo de moeda nem separadores de milhares. Um valor vazio significa que não foi definido um montante mínimo específico. O número não é convertido automaticamente a partir de dólares nem ajustado à taxa de câmbio.
«Confirmações mínimas» é outra condição. Não a altere para compensar um erro no montante. O limite é verificado para cada transferência avaliada: várias entradas mais pequenas não são somadas automaticamente para formar um pagamento que cumpra o critério.
Passo 3. Guarde e verifique a regra
Clique em «Adicionar endereço» e efetue a verificação de segurança apresentada, se a conta a exigir. Depois de guardar, abra o endereço, encontre a regra do projeto certo e verifique o ativo, o sentido e o mínimo registado. Confirme que a ligação está ativa; introduzir um número com sucesso não o comprova por si só.
Se um endereço for utilizado em vários projetos, verifique especificamente a regra selecionada. Outro projeto pode ter um limite diferente e receber outros eventos. A presença de uma transferência noutro projeto não significa que o seu mínimo tenha sido ignorado.
Passo 4. Verifique o limite sem uma transferência real
Para um limite de 10000000, os resultados esperados em unidades mínimas são os seguintes:
| Montante da transferência | Verificação do montante |
|---|---|
| 9999999 | Inferior ao limite, não cumpre |
| 10000000 | Igual ao limite, cumpre |
| 10000001 | Superior ao limite, cumpre |
Verifique estes casos com dados artificiais preparados numa verificação local da sua integração. Todos os exemplos têm de ter a mesma rede, ativo, endereço e sentido; caso contrário, estará a testar outra condição. Não é necessário enviar criptomoedas para verificar a aritmética do filtro. Esta verificação do limite não confirma a entrega de uma notificação ao destinatário escolhido: verifique separadamente o encaminhamento das notificações.
Se o resultado for diferente do esperado
Compare primeiro as unidades mínimas e a escala; depois, o ativo, o sentido, o projeto e se a regra está ativa. Verifique o montante efetivo da transferência, não a estimativa atual na moeda de apresentação. O TXID será útil para analisar o registo. Um evento de Monitorização não confirma, por si só, o pagamento de uma encomenda: é necessária a associação a uma fatura e a verificação do seu estado.