OneSpan Sign Developer: Unterschrift des Kontosenders überschreiben
Im vorherigen Blog “ Laden Sie eine Signatur für Ihren Unterzeichner hoch Wir haben untersucht, wie die erfasste Signatur in OneSpan Sign funktioniert und wie Sie eine Signatur für Ihre Unterzeichner hochladen, wenn Ihre Anwendung integriert ist und eine benutzerdefinierte Signatur von einem Signaturblock verwendet wird. Wir werden uns heute eingehender mit zwei Ausnahmeszenarien befassen, die beim Hochladen einer Signatur an Absender auftreten können, auf die Sie keinen Zugriff haben, und deren Absenderprofilsignatur Sie nicht ändern können.
Unterschrift des Absenders überschreiben
Wenn Sie ein Paket mit der hochgeladenen Signatur des Unterzeichners erstellen, fügen Sie einen handgezeichneten Wert direkt in den Block "Signatur" Ihrer Anforderungsnutzdaten ein. Diese Vorgehensweise gilt jedoch nur für Unterzeichner, deren E-Mail-Adresse nicht als Konto in OneSpan Sign registriert wurde. Wenn Sie mit einem Kontosender dasselbe tun, erkennt OneSpan Sign den Absender und ignoriert Ihre hochgeladene Signatur. Um die registrierte Signatur eines Absenders zu überschreiben, müssen Sie einige zusätzliche Schritte ausführen. Dieser Blog zeigt Ihnen die Details dieses Prozesses.
1. Erstellen Sie Ihr Paket und belassen Sie den Status als "ENTWURF".
2. Aktualisieren Sie die Signatur Ihres Unterzeichners
Rufen Sie zunächst die API auf. “ GET / api / packages / {packageID} / role / {roleID} ”, Um den JSON der gesamten Rolle zu erfassen.
Ersetzen Sie dann den handgezeichneten Wert durch die neue Signatur.
Als nächstes rufen Sie “ PUT / api / packages / {packageID} / role / {roleID} ”, Damit die Änderung wirksam wird.
3. Senden Sie Ihr Paket.
Wenn Sie zum ersten Mal einen Unterzeichner erstellen, erkennt OneSpan Sign den Absender und fügt die zugehörigen Rolleninformationen automatisch ein. Diese Rolleninformationen enthalten die handgezeichnete Signatur. Wenn diese Signatur bereits an den Unterzeichner angehängt ist, ignoriert OneSpan Sign Ihre hochgeladene Signatur und verwendet standardmäßig die Signatur, die bereits in der Datei enthalten ist. Durch diese drei oben genannten Schritte aktualisieren Sie den Unterzeichner manuell und OneSpan Sign stimmt nicht mehr mit dem Unterzeichner überein. Daher ist die Änderung gültig.
Hinweis:
- Dieser Vorgang ändert die ursprüngliche Signatur nicht und funktioniert nur einmal.
- Es kann die Signatur jedes Kontos außer Kraft setzen, einschließlich Ihres eigenen Kontos.
Unterschrift für einen Notar hochladen
Obwohl der oben beschriebene Vorgang in den meisten Situationen funktioniert, müssen Sie bestimmte Schritte ausführen, um eine Signatur hochzuladen, wenn ein Notar vorhanden ist.
Schritt 1
Erstellen Sie ein notariell beglaubigtes Paket, ohne die notaryRoleID zuzuweisen, und belassen Sie es im Status "ENTWURF". Ersetzen Sie mit der API die Notarrolleninformationen durch Ihre eigenen:
POST / api / packages
Autorisierung: Basic apikey
Akzeptieren: application / json
Inhaltstyp: mehrteilig / Formulardaten
Nutzlast anfordern:
{
"Rollen": [
{
"id": "role1",
"Typ": "SIGNER",
"index": 0,
"Unterzeichner": [
{
"E-Mail": "Ihre Notar-E-Mail",
"firstName": "notary.firstname",
"lastName": "notary.lastname"
}
],
"name": "Signer1"
},
{
"id": "role2",
"Typ": "SIGNER",
"index": 0,
"Unterzeichner": [
{
"id": "role2",
"email": "signer1 @mailinator .com ",
"Vorname": "1. Vorname",
"lastName": "1.lastname"
}
],
"name": "Signer2"
}
],
"Status": "ENTWURF",
"Unterlagen":[
......
],
"notariell beglaubigt": wahr,
"notaryRoleId": null,
"type": "PACKAGE",
"name": "Unterschrift für Notar testen"
}
Schritt 2
Update Unterschrift für Notar:
(1). Verwenden GET / api / packages / {packageID} / role / {notaryRoleID} und kopieren Sie den gesamten Antworttext
(2). Notar aktualisieren:
PUT / api / packages / {packageID} / role / {notaryRoleID}
Autorisierung: Basic apikey
Akzeptieren: application / json
Inhaltstyp: application / json
Nutzlast anfordern:
{
...
"Unterzeichner": [
{
...
"Unterschrift": {
"Text": null,
"handgezeichnet": "Ihr handgezeichneter Wert"
},
...
}
],
”Name”: ”Signer1”
}
Sie fügen den Antworttext in Ihre Nutzlast ein und ersetzen den handgezeichneten Wert durch Ihren eigenen.
Schritt 3
Vergeben Sie notaryRoleID in der Paketebene:
PUT / api / packages / {packageID}
Autorisierung: Basic apikey
Akzeptieren: application / json
Inhaltstyp: application / json
Nutzlast anfordern:
{
"notaryRoleId": "Ihre Notar-ID"
}
Schritt 4
Senden Sie das Paket:
PUT / api / packages / {packageID}
Autorisierung: Basic apikey
Akzeptieren: application / json
Inhaltstyp: application / json
Nutzlast anfordern:
{
"status": "SENT"
}
Hinweis:
- Schritt 3 und Schritt 4 müssen über zwei separate API-Aufrufe erfolgen.
Der Hauptgrund für diese vier Schritte ist, dass Sie eine Fehlermeldung erhalten, die besagt, dass Sie einen Notar nicht bearbeiten können, wenn Sie den im ersten Abschnitt beschriebenen Vorgang ausführen. Wenn Sie jedoch erst einen Notar beauftragen, nachdem Sie seinen handgezeichneten Wert aktualisiert haben, können Sie diesen Fehler vermeiden, und alles funktioniert wie erwartet.
Wenn Sie Zugriff auf Ihre Absender und Notare haben, ist es immer noch besser, die Signatur Ihres Absenderprofils zu aktualisieren, und es wird immer empfohlen, den gesamten Prozess in Postman zu testen, bevor Sie ihn in Code implementieren.
Wenn Sie Fragen zu diesem Blog oder zu anderen Aspekten der Integration von OneSpan Sign in Ihre Anwendung haben, besuchen Sie die Entwickler-Community-Foren . Ihr Feedback ist uns wichtig!
