Updated on 27 juin 2024

Notifications email/sms

Temps estimé :5 minutes

1/ Introduction

Les notifications peuvent être adressées en fonction des évènements liés à certains objets API :

  • Demande de paiement (PaymentRequest)
  • Contestation carte (dispute)
  • Paiement X fois (installment)
  • Transaction carte (transaction)
  • Reversement (payout)
  • Remboursement carte (refund)
  • Abonnement (subscription)
  • Crédit carte (credit)
  • Transaction SDD (sddTransaction)
  • Transaction SDD inversée (sddTransactionReversal)
  • Mandat (mandate)

2/ Types de scénarios de notification

Notifiez vos clients et alertez vos collaborateurs automatiquement lorsque certains évènements ont lieu sur votre compte CentralPay : encaissement d’un virement, contestation client, échec de règlement…
Vous maitrisez le contenu de chaque notification depuis des templates personnalisés et définissez un mode d’envoi par email, par sms ou par Json. Vous automatisez ainsi le pointage de vos encaissements, les notifications clients, ou encore la mise à jour de votre système d’information.

3/ Paramétrage des modèles de notification

3.1/ Paramétrage des modèles (templates)

Pour commencer le paramétrage de vos notifications, vous devez créer vos modèles de communication (email, sms ou hook) en renseignant les éléments demandés. Par exemple l’objet du mail, le nom et email de l’émetteur, le corps du texte…

Vous pouvez intégrer des éléments dynamiques (tags) dans le corps du texte en tapant le caractère « # », qui fera apparaitre la liste des tags disponible pour le type de scénario de notification sélectionné.

Attention, si vous utilisez les notifications emails, veillez à nous demander de vous communiquer nos clés SPF et DKIM afin que vous puissiez autoriser CentralPay à envoyer des emails depuis votre domaine.

Concernant les SMS, veillez à calculer le nombre de caractères : vous serez facturés d’un SMS par 160 caractères (espaces inclus).

3.2/ Paramétrage du header et footer pour templates emails

En cas de création d’un template email, un « header » et un « footer » devront être créés. Vous pouvez par exemple intégrer votre logo en Header, et vos conditions de contact ou mentions légales en Footer.

4/ Paramétrage des scénarios de notification

Pour spécifier à la plateforme les conditions d’envoi et destinataires de vos notifications, vous devez créer un scénario intégrant une ou plusieurs règles d’envoi.

Après avoir choisi le type de scénario souhaité, vous pouvez créer une règle d’envoi. Cette règle est scindée en deux parties : le “QUAND” va permettre de définir l’évènement déclencheur de la notification tandis que le “ALORS” va permettre de choisir les actions qui seront effectuées lorsque l’évènement se produira.

4.1/ Dans la partie « QUAND » :

  • Tapez « # » pour visualiser l’ensemble des attributs disponible pour votre scénario
  • Utilisez des opérateurs logiques pour constituer votre règle :
    • Pour les chaînes de caractères (doivent être entourés de guillemets «  ») :
      • = (égal)
      • != (différent de)
      • in (dans ce qui va suivre)
      • not in (pas dans ce qui va suivre)
    • Pour les nombres (attention les montants doivent être renseignés en centimes) :
      • = (égal)
      • != (différent de)
      • < (plus petit que)
      • <= (plus petit ou égal à)
      • in (dans ce qui va suivre)
      • not in (pas dans ce qui va suivre)
    • Pour les boolean (affirmations en vrai ou faux) :
      • = (égal à)
      • != (différent de)
  • Vous pouvez utiliser des conditions pour compléter votre règle :
    • AND (pour ajouter une autre condition d’activation)
    • OR (pour ajouter une autre possibilité d’activition)

Il est possible de donner des priorités en mettant des parenthèses autour des conditions. Si vous utilisez les conditionnels AND et OR dans la même règle, il est nécessaire de prioriser. Si vous utilisez plusieurs fois AND ou plusieurs fois OR, il sera également nécessaire de prioriser chaque partie.

Exemples de règles :

#end_user_country in ('FRA', 'BE')

#authorisation_status = 'FAILURE' or (#transaction_amount > 100000 and #context = 'TRANSACTION_RISKY' )

#transaction_amount > 100000 and ( #authorisation_status = 'FAILURE' or #context = 'TRANSACTION_RISKY' )

((#transaction_amount > 100000 and #context = 'TRANSACTION_RISKY') or ( #authorisation_status = 'FAILURE' and #transaction_amount < 100000 )) and (#card_product_type = 'Consumer')

Avant de pouvoir enregistrer une règle, il est obligatoire de d’abord tester sa règle avec le bouton « tester ». Cela va permettre de vérifier que votre règle est grammaticalement correcte. Attention, cela ne garantit pas que votre règle correspond à ce que vous souhaitiez faire.

4.2/ Dans la partie « ALORS » :

Le “ALORS” va permettre de choisir le destinataire et le template utilisé pour la notification. Vous n’avez accès qu’aux templates qui correspondent au type de template requis (SMS, Email, Hook) et qui correspond au type de scénario choisi (transaction carte, demande de paiement, remboursement …).

Prochain- Services liés au compte Services anti-fraude
CONTENU