E-mails et notifications

Configurez les canaux, modèles, livraisons et frais des notifications.

Avis obligatoires du compte

Les crédits de solde, les mises à jour des retraits, les résultats des abonnements et les changements de sécurité génèrent des avis dans l’application et des e-mails au compte. Les modèles du marchand ne peuvent pas les désactiver.

Notifications et modèles

Gérer les canaux ouvre la gestion des canaux dans un panneau latéral sur la page actuelle. Ajoutez en haut à droite ou modifiez depuis la liste, dans une boîte de dialogue. Les onglets Canaux / Historique des notifications permettent de passer des canaux aux notifications enregistrées. Les paramètres de notification ne figurent plus dans la barre latérale. Les deux panneaux glissent dans la page sans changer l’URL et conservent leurs filtres et leur pagination.

Les interrupteurs contrôlent les notifications ; les cartes affichent les modèles actifs comme étiquettes.

Un modèle de paiement est lié à un canal précis ; un seul est autorisé par événement, canal et langue. Les nouveaux modèles sont désactivés. Chaque destinataire utilise le contenu actif dans la langue de notification, puis en anglais, au plus une fois par événement. Les listes restent dans des panneaux et les formulaires s’ouvrent dans des boîtes de dialogue. L’abandon de modifications demande confirmation et la fermeture est bloquée pendant les opérations. Les tests envoient uniquement au destinataire choisi sans enregistrer ni activer le modèle.

Les variables des modèles de paiement sont repliées au-dessus d’Annuler et Enregistrer. Dépliez-les puis cliquez sur une variable pour l’insérer.

Les modèles par défaut de revenus et de dépenses du portefeuille en anglais et en chinois portent Telegram dans leur titre. Le contenu commence par l’étiquette du flux de fonds, sans emoji initial.

Sur ordinateur, faites glisser le bord gauche du panneau des modèles pour ajuster sa largeur. Faites glisser le coin inférieur droit de l’éditeur de contenu pour ajuster sa hauteur, limitée à 600px ou à 70% de la hauteur de la fenêtre, selon la valeur la plus petite.

Configurez modèles et canaux depuis les engrenages du formulaire. Les listes s’ouvrent dans des panneaux et les formulaires dans des boîtes de dialogue conservant le brouillon de l’adresse. Envoyer un test utilise uniquement le canal enregistré et le modèle de cette ligne, sans enregistrer l’adresse ni confirmer un transfert réel. Lorsqu’une adresse surveillée est désactivée, supprimée ou suspendue pour facturation, les alertes échouées ne sont plus retentées et leur renvoi manuel est bloqué. Les messages déjà envoyés ne sont pas rappelés.

Les tests Telegram renvoient le code 10036 lorsque le jeton du bot est refusé (401 Unauthorized). Vérifiez ou remplacez le jeton avec BotFather. Pour un canal enregistré, un jeton masqué conserve les identifiants enregistrés ; saisissez le nouveau jeton complet pour le remplacer.

Livraison et nouvelles tentatives

Consultez l’historique avant de réessayer. Les e-mails en échec font l’objet de cinq tentatives au maximum, à intervalles croissants. Le rattrapage et le renvoi des avis de portefeuille respectent l’état de l’adresse et la limite de 72 heures ci-dessous.

La surveillance des portefeuilles ne notifie que les transactions dont la date sur la blockchain remonte à 72 heures au maximum. Cette limite s’applique au premier scan, aux notifications de rattrapage et aux nouvelles tentatives. Les transactions plus anciennes peuvent rester dans l’historique, mais ne déclenchent plus de notification dans l’application, sur les canaux externes ou par Webhook.

Langue des e-mails

Les e-mails prennent en charge l’anglais et le chinois. La sélection suit la langue de l’événement, celle des e-mails du marchand, celle de l’interface du compte, puis l’anglais.

Webhook indépendant

Un seul Webhook de surveillance est géré dans la section Webhook sous les modèles des paramètres de notification et ne réutilise ni la configuration des Webhooks de paiement ni les Webhooks de notification. La configuration possède sa portée d’événements et d’adresses, son secret, sa signature HMAC-SHA256, ses reprises et son JSON versionné. Toute modification de l’URL, de la portée, des événements ou du secret la désactive jusqu’à un nouveau test réussi. Les anciens Webhooks restent en lecture seule ; utilisez la migration pour créer et tester la configuration.

Vérifiez chaque requête avec le corps brut avant d’analyser le JSON. Lisez X-PolyPay-Timestamp et X-PolyPay-Signature (t=<timestamp>,v1=<hex>), calculez HMAC-SHA256 avec le secret complet whsec_... sur <timestamp>.<raw body>, puis comparez les octets en temps constant. Refusez les horodatages qui s’écartent de plus de 5 minutes de l’heure actuelle et ne traitez chaque id du payload qu’une seule fois. Chaque requête de test utilise un ID d’événement de test unique.

Offres et utilisation

Les abonnements de paiement, quotas de commandes et usages des portefeuilles de réception sont propres à chaque marchand. Les plans de surveillance, adresses surveillées et quotas de notifications appartiennent au compte ; changer de marchand ne crée pas un autre quota de surveillance.

Les notifications de paiement destinées aux personnes et les Webhooks de surveillance sont illimités. Seule la première livraison réussie d’un avis de surveillance à une personne par destination consomme le quota du compte ou entraîne les frais PAYG applicables. Les échecs, avis internes et avis système ne le consomment pas.