Développeur de signes OneSpan : Notification d'événement de rappel - Partie 1
Imaginez que vous développez une intégration personnalisée du tableau de bord des transactions avec OneSpan Sign. Pour actualiser l'état de vos transactions, il n'y a qu'une seule option viable.
Afin de faciliter votre intégration et de rester en conformité avec les meilleures pratiques de programmation, OneSpan Sign fournit un mécanisme de crochet Web appelé «notification d'événement de rappel. En tant que l'une des fonctionnalités les plus largement utilisées, les notifications d'événements de rappel vous permettent d'être automatiquement informé des événements relatifs à un paquet.
Dans ce blog, nous allons parcourir les 20 événements que vous pouvez enregistrer et les classer en plusieurs parties pour fournir une meilleure idée de ce genre de notifications d'événements d'information peuvent offrir.
Changement d'état du paquet :
- PACKAGE_CREATE (DRAFT)
- TEMPLATE_CREATE (DRAFT)
- PACKAGE_ACTIVATE (SENT)
- PACKAGE_DEACTIVATE (DRAFT)
- PACKAGE_COMPLETE (COMPLETED)
- PACKAGE_DECLINE (DECLINED)
- PACKAGE_OPT_OUT (OPTED_OUT)
- PACKAGE_EXPIRE (EXPIRED)
- PACKAGE_ARCHIVE (ARCHIVÉ)
Actions de manipulation de paquets :
- PACKAGE_TRASH (Action Trash)
- PACKAGE_RESTORE (Restauration action)
- PACKAGE_DELETE (Supprimer l'action)
Les événements énumérés ci-dessus couvrent tous les changements possibles d’état de paquet et de modèle, qui est un cas important d’utilisation pour la notification d’événement. Une solution potentielle pour la construction d’un tableau de bord des transactions qui reflète le changement de statut en temps réel pourrait être :
(1) Vous configurez une base de données pour stocker toutes les informations de paquet s'y sont créées.
(2) Une fois que l'un des rappels ci-dessus est déclenché, vous pouvez mettre à jour l'état du paquet dans votre base de données.
(3) Fonction de talon d'appel si vous avez votre propre logique d'entreprise basée sur le changement de statut spécifique.
(4) Pour vos utilisateurs front end, vous pouvez rendre votre page d'entrée en sonde votre base de données locale.
(5) Toutes les 6, 12 ou 24 heures, votre application peut sonder les derniers paquets mis à jour et mettre à jour votre base de données locale en tant que sauvegarde au cas où vous auriez manqué des demandes de rappel.
De cette façon, vous pouvez éviter de fréquemment sonder les dernières informations et réduire considérablement la charge de serveur de OneSpan Sign.
Si vous n'êtes pas familier avec l'état du paquet, consultez notre récent blog: Cycle de vie d'un paquet.
Changement de statut de signature :
- DOCUMENT_SIGNED
- SIGNER_COMPLETE
Avec l'événement DOCUMENT_SIGNED, vous recevrez des mises à jour en temps réel avec des informations importantes chaque fois qu'un signataire signe un document.
Avec l'événement SIGNER_COMPLETE et une intégration avec la base de données locale, votre application saura combien de signataires ont terminé ou sont laissés à signer. Cet événement aidera à déclencher le bon moment de signature lorsqu'une séquence de signature spécifique est nécessaire.
Événements intéressants lors de la cérémonie de signature
- SIGNER_LOCKED
- KBA_FAILURE
- EMAIL_BOUNCE
- PACKAGE_READY_FOR_COMPLETION
Lorsque ces événements se produisent, votre expéditeur de colis doit être informé et prendre les mesures correspondantes pour poursuivre le processus de signature.
- ROLE_REASSIGN
- PACKAGE_ATTACHMENT
Les deux événements ci-dessus indiquent à votre application que le contenu du paquet est mis à jour pendant la phase de signature.
Créer un auditeur de rappel
Jusqu'à présent, nous avons examiné les notifications d'événements et le flux de travail recommandé pour les transactions de sondage, les signataires, ou tout autre bit d'informations. Dans les prochains blogs de cette série, nous allons introduire les notifications d'événements d'une manière technique et détaillée et de démontrer les processus recommandés pour le traitement d'un rappel dans différents langages de programmation.
Toutes ces informations sont également disponibles sur notre page Create a Callback Event Notification Listener.
Si vous avez des questions concernant ce blog ou toute autre chose concernant l'intégration de OneSpan Sign dans votre application, visitez les Forums communautairesdes développeurs . Vos commentaires sont importants pour nous!
OneSpan Sign Developer Community
Rejoignez la communauté OneSpan Sign Developer! Forums, blogs, documentation, téléchargements SDK, et plus encore.
Joignez-vous aujourd'hui