OneSpan Sign Developer: Remplacer la signature de l'expéditeur de compte
Dans le blog précédent "Upload Signature for Your Signer", nous avons exploré comment la signature capturée fonctionne dans OneSpan Sign et comment télécharger une signature pour vos signataires si votre application est intégrée et en utilisant une signature personnalisée à partir d'un pad de signature. Aujourd'hui, nous allons aller plus loin et discuter de deux scénarios d'exception que vous pouvez rencontrer lors du téléchargement d'une signature pour les expéditeurs avec lesquels vous n'avez pas accès, et vous ne pouvez pas modifier leur signature de profil expéditeur.
Remplacer la signature de l'expéditeur de compte
Lors de la création d'un paquet avec la signature du signataire téléchargé, vous ajoutez une valeur dessinée à la main dans le bloc "signature" dans votre charge utile de demande directement. Toutefois, cette pratique ne fonctionne que pour les signataires dont l'e-mail n'a pas été enregistré en tant que compte dans OneSpan Sign. Si vous faites la même chose avec un expéditeur de compte, OneSpan Sign reconnaîtrait l'expéditeur et ignorerait votre signature téléchargée. Pour obtenir une dérogation de la signature enregistrée d'un expéditeur, vous devrez faire quelques étapes supplémentaires. Ce blog vous montrera les détails de ce processus.
1. Créez votre colis et laissez le statut de " DRAFT ".
2. Mettre à jour la signature de votre signataire
Tout d'abord, appelez l'API "GET /api/packages/packageID/roles/ "roleID"pour s'emparer du JSON du rôle.
Ensuite, remplacez la valeur dessinée à la main par la nouvelle signature.
Ensuite, appelez «PUT /api/packages/packageID/roles/RoleID »pour permettre à la modification d'entrer en vigueur.
3. Envoyez votre colis.
La première fois que vous créez un signataire, OneSpan Sign reconnaîtra l'expéditeur et injectera automatiquement les informations de rôle connexes. Cette information de rôle inclut la signature dessinée à la main. Avec cette signature déjà jointe au signataire, OneSpan Sign ignore votre signature téléchargée et par défaut à la signature qu'il a déjà dans le fichier. Grâce à ces trois étapes mentionnées ci-dessus, vous mettez à jour le signataire manuellement et OneSpan Sign ne correspondpas plus au signataire. Par conséquent, la modification est valide.
Note:
- Ce processus ne modifiera pas réellement la signature d'origine et ne fonctionnera qu'une seule fois.
- Il peut remplacer la signature de n'importe quel compte, y compris votre propre compte.
Télécharger la signature pour un notaire
Bien que le processus ci-dessus fonctionnera dans la plupart des situations, il ya des mesures spéciales que vous devez prendre pour télécharger une signature quand un notaire existe.
Étape 1
Créez un package notarié sans affecter le notaireRoleID et laissez-le en état "DRAFT". Avec l'API, remplacez l'information sur le rôle de notaire par la vôtre :
POST /api/packages
Autorisation: Apikey de base
Accepter : application/json
Type de contenu : multipart/form-data
Demande de charge utile:
{
"rôles":[
{
"id":"role1",
"type":"SIGNER",
"index":0,
"signataires":[
{
"email":"votre email de notaire",
"firstName":"notary.firstname",
"lastName":"notary.lastname"
}
],
"nom":"Signer1"
},
{
"id":"role2",
"type":"SIGNER",
"index":0,
"signataires":[
{
"id":"role2",
"email":"signer1.com",
"firstName":"1.firstname",
"lastName":"1.lastname"
}
],
"nom":"Signer2"
}
],
"statut":"DRAFT",
"documents":[
......
],
"notarié":vrai,
"notaryRoleId":null,
"type":"PACKAGE",
"nom":"test upload signature for notary"
}
Étape 2
Signature de mise à jour pour notaire:
(1). Utilisez GET /api/packages/'packageID/roles/'notaryRoleID' et copiez l'ensemble du corps de réponse
(2). Notaire de mise à jour:
PUT /api/packages/'packageID/roles/'notaryRoleID
Autorisation: Apikey de base
Accepter : application/json
Type de contenu : application/json
Demande de charge utile:
{
...
"signataires": [
{
...
"signature": {
"textuel": nul,
"tiré à la main": "votre valeur tirée à la main"
},
...
}
],
"nom":" Signer1"
}
Vous collerez le corps de réponse dans votre charge utile et remplacerez la valeur dessinée à la main par la vôtre.
Étape3
Attribuer notaryRoleID au niveau du package :
PUT /api/packages/ 'packageID'
Autorisation: Apikey de base
Accepter : application/json
Type de contenu : application/json
Demande de charge utile:
{
"notaryRoleId": "votre id notaire"
}
Étape4
Envoyer le colis:
PUT /api/packages/ 'packageID'
Autorisation: Apikey de base
Accepter : application/json
Type de contenu : application/json
Demande de charge utile:
{
"statut": "SENT"
}
Note:
- L'étape 3 et l'étape 4 doivent être effectuées au moyen de deux appels API distincts.
Le point principal derrière ces quatre étapes est, si vous suivez le processus que nous avons fait dans la première section, vous recevrez une erreur qui dit "vous ne pouvez pas modifier un notaire". Mais, si vous n'attribuez pas un notaire jusqu'à la mise à jour de sa valeur dessinée à la main, vous êtes en mesure d'éviter cette erreur, et tout fonctionne comme prévu.
Si vous avez accès à vos expéditeurs et notaires, il est toujours préférable de mettre à jour la signature de votre profil d'expéditeur, et il est toujours recommandé de tester l'ensemble du processus dans Postman avant de l'implémenter en code.
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!
