Entwicklerzentrum

Webhook-Ereignis

Erläuterung zu Webhook-Callback-Nachrichten

Die Callback-Adresse muss über eSignGlobal aufgerufen werdenEinstellungen - Integration - Webhookder Konfigurationsseite.

Der an eSignGlobal zurückgegebene HTTP-Statuscode liegt zwischen200~299eSignGlobal betrachtetBenachrichtigung als erfolgreich, andernfalls betrachtet eSignGlobalBenachrichtigung als fehlgeschlagen

  • Nach einem fehlgeschlagenen Benachrichtigungsversuch führt der eSignGlobal-Benachrichtigungsdienstbis zu 16 Wiederholungsversuchedurch. Der Wiederholungsmechanismus ist wie folgt:

(Verschiedene Module können einen der folgenden beiden Wiederholungsmechanismen verwenden. Wenn die Benachrichtigung während eines Wiederholungsversuchs erfolgreich ist, wird der Vorgang abgebrochen und nicht fortgesetzt.):

image.png
  • Um zu vermeiden, dass wiederholte Benachrichtigungen aufgrund eines Fehlers beim Parsen von JSON-Daten durch den eSignGlobal-Benachrichtigungsdienst gesendet werden, stellen Sie bitte sicher, dass die zurückgegebenen JSON-Daten keine Leerzeichen \/oder Sonderzeichen enthalten. Es wird empfohlen, bei erfolgreichem Empfang direkt Folgendes zurückzugeben: {"code":"200","msg":"success"}
  • Um die Aktualität und Zuverlässigkeit von Callback-Benachrichtigungen zu gewährleisten, wird Entwicklern empfohlen, nach Erhalt einer Callback-Benachrichtigung innerhalb von5 SekundenzurückzugebenHTTP-Statuscode (200)an den eSignGlobal-Benachrichtigungsdienst.
  • Wenn Entwickler die zugehörige Geschäftsabwicklung für Callback-Benachrichtigungen nicht innerhalb von 5 Sekunden abschließen können, verwenden Sie bitte eine asynchrone Methode für die weitere Geschäftsabwicklung.

 

Ereignisliste

Modul

Ereignistyp Aktion

Ereignisname

Ereignisbeschreibung

Documents

ENVELOPE_START

Envelope Start

Nach dem Start des Signaturprozesses

ENVELOPE_SIGNER_SIGNED

Envelope Signer Signed

Sobald der Unterzeichnungsprozess gestartet wurde, hat ein beliebiger Unterzeichner die Unterzeichnung abgeschlossen

ENVELOPE_ALL_SIGNER_SIGNED

Envelope All Signer Signed

Sobald der Unterzeichnungsprozess gestartet wurde, haben alle Unterzeichner die Unterzeichnung abgeschlossen

ENVELOPE_FINISH

Envelope Finish

Der Unterzeichnungsprozess ist abgeschlossen

ENVELOPE_CANCEL

Envelope Cancel

Nachdem der Unterzeichnungsprozess gestartet wurde, hat der Initiator den Unterzeichnungsprozess abgebrochen

ENVELOPE_EXPIRED

Envelope Expired

Die Durchlaufzeit des Unterzeichnungsprozesses hat die Gültigkeitsdauer überschritten

Erläuterung zu Webhook-Callback-Nachrichten
Ereignisliste