E-mail e notificações

Configure canais, modelos, entregas e cobrança de notificações.

Avisos obrigatórios da conta

Créditos de saldo, atualizações de saques, resultados de assinaturas e alterações de segurança geram avisos no aplicativo e e-mails para a conta. Os modelos do comerciante não podem desativá-los.

Notificações e modelos

Gerenciar canais abre a gestão de canais em um painel lateral na página atual. Adicione no canto superior direito ou edite pela lista, em diálogos. Use as abas Canais / Histórico de notificações para alternar entre canais e registros de notificações. As configurações de notificação não aparecem mais na barra lateral. Os dois painéis deslizam na mesma página sem alterar a URL, preservando filtros e paginação.

Os interruptores controlam as notificações; os cartões mostram modelos ativos como etiquetas.

Os modelos de pagamento vinculam um canal específico; só é permitido um por evento, canal e idioma e os novos começam desativados. Cada destino usa conteúdo ativo no idioma da notificação e depois em inglês, no máximo uma vez por evento. As listas ficam em painéis e os formulários usam diálogos. É pedida confirmação antes de descartar alterações e o fecho é bloqueado durante operações. Os testes enviam apenas para o destino escolhido sem guardar ou ativar o modelo.

As variáveis dos modelos de pagamento estão recolhidas acima de Cancelar e Guardar. Expanda-as e clique numa variável para a inserir.

Os modelos predefinidos de entradas e saídas da carteira em inglês e chinês incluem Telegram no título. O conteúdo começa com a etiqueta do fluxo de fundos, sem emojis iniciais.

No computador, arraste a margem esquerda do painel de modelos para ajustar a largura. Arraste o canto inferior direito do editor de conteúdo para ajustar a altura, até 600px ou 70% da altura da janela, consoante o menor valor.

Configure modelos e canais nos ícones de engrenagem do formulário. As listas abrem em painéis e os formulários em diálogos que preservam o rascunho do endereço. Enviar teste usa apenas o canal guardado e o modelo dessa linha; não guarda o endereço nem confirma uma transferência real. Quando um endereço monitorado é desativado, excluído ou pausado por cobrança, os alertas com falha deixam de ser reenviados e o reenvio manual é bloqueado. Mensagens já enviadas não são removidas.

Os testes do Telegram retornam o código 10036 quando o token do bot é rejeitado (401 Unauthorized). Verifique ou substitua o token com o BotFather. Ao testar um canal salvo, um token mascarado mantém as credenciais salvas; insira o novo token completo para substituí-lo.

Entrega e novas tentativas

Confira o histórico antes de tentar novamente. E-mails com falha têm até cinco tentativas, com intervalos crescentes. Avisos de carteira recuperados e reenvios respeitam o estado do endereço e o limite de 72 horas abaixo.

O monitoramento de carteiras só notifica transações cujo horário na blockchain esteja nas últimas 72 horas. Esse limite se aplica à varredura inicial, às notificações pendentes e às novas tentativas. Transações mais antigas podem permanecer no histórico, mas não geram notificações no aplicativo, em canais externos ou por Webhook.

Idioma do e-mail

E-mails aceitam inglês e chinês. A seleção segue o idioma do evento, o idioma de e-mail do comerciante, o idioma da interface da conta e, por último, inglês.

Webhook independente

Um único Webhook de monitoramento é gerenciado na seção Webhook abaixo dos modelos das Configurações de notificação e não reutiliza a configuração de Webhooks de pagamento nem Webhooks de canais. A configuração tem escopo próprio de eventos e endereços, segredo, assinatura HMAC-SHA256, estado de repetição e JSON versionado. Alterar URL, escopo, eventos ou segredo a desativa até um novo teste bem-sucedido. Webhooks legados ficam somente leitura; use a migração para criar e testar a configuração.

Verifique cada solicitação usando o corpo bruto antes de analisar o JSON. Leia X-PolyPay-Timestamp e X-PolyPay-Signature (t=<timestamp>,v1=<hex>), calcule HMAC-SHA256 com o segredo completo whsec_... sobre <timestamp>.<raw body> e compare os bytes em tempo constante. Rejeite timestamps com mais de 5 minutos de diferença em relação ao horário atual e processe cada id do payload apenas uma vez. Cada solicitação de teste usa um ID de evento de teste exclusivo.

Planos e uso

Planos de pagamento, limites de pedidos e uso de carteiras receptoras pertencem a cada comerciante. Planos de monitoramento, endereços monitorados e limites de avisos pertencem à conta; trocar de comerciante não cria outro limite de monitoramento.

Avisos de pagamento para pessoas e Webhooks de monitoramento são ilimitados. Apenas a primeira entrega bem-sucedida de um aviso de monitoramento para pessoas por destino consome o limite da conta ou gera a cobrança PAYG aplicável. Falhas, avisos internos e avisos do sistema não o consomem.