--- title: "Ajouter, mettre à jour et supprimer des signataires" slug: "adding-updating-and-removing-signers" updated: 2026-05-12T13:11:39Z published: 2026-05-12T13:13:27Z canonical: "docs.onespan.com/adding-updating-and-removing-signers" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.onespan.com/llms.txt > Use this file to discover all available pages before exploring further. # Ajouter, mettre à jour et supprimer des signataires ## Java SDK Pour télécharger l’exemple complet de code, consultez notre site [de partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/signer-management-example-java-sdk/) . L’une des opérations les plus fondamentales et fondamentales de OneSpan Sign consiste à inviter les signataires à signer des documents. Ce sujet décrit comment ajouter, mettre à jour et supprimer des signataires d’une transaction. Pour garantir la sécurité de vos transactions, n’utilisez pas d’adresses e-mail factices pour vos destinataires. ### Ajout de signataires à une transaction Pour ajouter un signataire à une transaction existante, vous devez d’abord créer l’objet Signer . Le code suivant créera un objet Signer : Notez que cet exemple de code inclut également [les notifications SMS](/v1/docs/fr/sms-notifications) comme méthode principale de notification. Les méthodes de notification suivantes sont disponibles : - [EMAIL, SMS] - les notifications par email et SMS sont envoyées au signataire (le numéro de téléphone est obligatoire) - [EMAIL] - seules les notifications par email sont envoyées au signataire (le numéro de téléphone est optionnel) - {SMS] - seules les notifications SMS sont envoyées au signataire (le numéro de téléphone est obligatoire). Notes : L’email du destinataire reste **obligatoire** pour la création de transactions ```java Signer signer = SignerBuilder.newSignerWithEmail("signer@example.com")    .withFirstName("John")    .withLastName("Smith")    .withCustomId("Signer1")    .build(); .withNotificationMethods(NotificationMethodsBuilder.newNotificationMethods()        .withPrimaryMethods(NotificationMethod.EMAIL, NotificationMethod.SMS)        .withPhoneNumber("+15141234567")))  // in E.164 international format .withSigner(newSignerWithEmail("your.email@example.com") .withFirstName("YourFirstName") .withLastName("YourLastName")) ``` Pour des informations sur la mise à jour des méthodes d’authentification utilisées pour les transactions, voir [Authentification des signataires](/v1/docs/fr/authenticating-signers#java-sdk). Une fois l’objet Signer créé, trouvez le PackageId qui vous est retourné lors de la création de la transaction et utilisez le client OneSpan Sign pour ajouter votre signataire. Le code suivant le fera ainsi : ```java String signerId = eslClient.getPackageService().addSigner(packageId, signer); ``` ### Mise à jour d’un signataire existant De même, pour mettre à jour un signataire existant, vous devez créer un objet Signer contenant les mises à jour que vous souhaitez apporter à votre signataire. Le code suivant le fera ainsi : ```java Signer updatedSigner = SignerBuilder.newSignerWithEmail("mary.doe@example.com")    .withFirstName("Mary")    .withLastName("Doe")    .withCustomId("Signer1")    .build(); ``` Une fois que vous avez mis à jour le signataire, trouvez le PackageId (la transaction) dans lequel vous souhaitez changer ce signataire, et utilisez le client OneSpan Sign pour le mettre à jour. ```java eslClient.getPackageService().updateSigner(packageId, updatedSigner); ``` ### Suppression des signataires d’une transaction Pour retirer un signataire d’une transaction, il suffit d’appeler la fonction removeSigner avec la chaîne packageId et signerId . ```java eslClient.getPackageService().removeSigner(packageId, signerId); ``` ### Résultats Après avoir exécuté votre code, si vous vous connectez à OneSpan Sign et que vous naviguez vers votre forfait, vous verrez votre signataire dans votre transaction. ## .NET SDK Pour télécharger l’exemple complet de code, consultez notre site [de partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/signer-management-example-net-sdk/) . L’une des opérations les plus fondamentales et fondamentales de OneSpan Sign consiste à inviter les signataires à signer des documents. Ce sujet décrit comment ajouter, mettre à jour et supprimer des signataires d’une transaction. Pour garantir la sécurité de vos transactions, n’utilisez pas d’adresses e-mail factices pour vos destinataires. ### Ajout de signataires à une transaction Pour ajouter un signataire à une transaction existante, vous devez d’abord créer l’objet Signer . Le code suivant créera un objet Signer : Notez que cet exemple de code inclut également [les notifications SMS](/v1/docs/fr/sms-notifications) comme méthode principale de notification. Les méthodes de notification suivantes sont disponibles : - [EMAIL, SMS] - les notifications par email et SMS sont envoyées au signataire (le numéro de téléphone est obligatoire) - [EMAIL] - seules les notifications par email sont envoyées au signataire (le numéro de téléphone est optionnel) - {SMS] - seules les notifications SMS sont envoyées au signataire (le numéro de téléphone est obligatoire). Notes : L’email du destinataire reste **obligatoire** pour la création de transactions ```csharp var signer = SignerBuilder.NewSignerWithEmail("signer@example.com")    .WithFirstName("John")    .WithLastName("Smith")    .WithCustomId("Signer1")    .Build(); var role = RoleBuilder.NewRole("Signer1")    .WithSigner(signer)    .WithNotificationMethods(        NotificationMethodsBuilder.NewNotificationMethods()            .WithPrimaryMethods(NotificationMethod.EMAIL, NotificationMethod.SMS)            .WithPhoneNumber("+15141234567") // E.164 format    )    .Build(); ``` Une fois que vous avez mis à jour le signataire, trouvez le PackageId (la transaction) dans lequel vous souhaitez changer ce signataire, et utilisez le client OneSpan Sign pour le mettre à jour. ```csharp String signerId = eslClient.PackageService.AddSigner(packageId, signer); ``` Pour des informations sur la mise à jour des méthodes d’authentification utilisées pour les transactions, voir [Authentification des signataires](/v1/docs/fr/authenticating-signers#java-sdk). ### Mise à jour d’un signataire existant De même, pour mettre à jour un signataire existant, vous devez créer un objet Signer contenant les mises à jour que vous souhaitez apporter à votre signataire. Le code suivant le fera ainsi : ```csharp Signer updatedSigner = SignerBuilder.NewSignerWithEmail("mary.doe@example.com")    .WithFirstName("Mary")    .WithLastName("Doe")    .WithCustomId("Signer1")    .Build(); ``` Une fois que vous avez mis à jour le signataire, trouvez le PackageId (la transaction) dans lequel vous souhaitez changer ce signataire, et utilisez le client OneSpan Sign pour le mettre à jour. ```csharp eslClient.PackageService.UpdateSigner(packageId, updatedSigner); ``` ### Suppression des signataires d’une transaction Pour retirer un signataire d’une transaction, il suffit d’appeler la fonction removeSigner avec la chaîne packageId et signerId . ```csharp eslClient.PackageService.UpdateSigner(packageId, updatedSigner); ``` ### Résultats Après avoir exécuté votre code, si vous vous connectez à OneSpan Sign et que vous naviguez vers votre forfait, vous verrez votre signataire dans votre transaction. ## REST API Pour télécharger l’exemple complet de code, consultez notre site [de partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/signer-management-example-rest-api/) . L’une des opérations les plus fondamentales et fondamentales de OneSpan Sign consiste à inviter les signataires à signer des documents. Ce sujet décrit comment ajouter, mettre à jour et supprimer des signataires d’une transaction. Pour garantir la sécurité de vos transactions, n’utilisez pas d’adresses e-mail factices pour vos destinataires. ### Ajout de signataires à une transaction Pour ajouter un signataire à une transaction existante, utilisez le code suivant : #### Requête HTTP ```http POST /api/packages/{packageId}/roles ``` Pour des informations sur la mise à jour des méthodes d’authentification utilisées pour les transactions, voir [Authentification des signataires](/v1/docs/fr/authenticating-signers#java-sdk). #### En-têtes HTTP ```http Accept: application/json   Content-Type: application/json   Authorization: Basic api_key ``` #### Charge utile de demande ```json {  "id": "Signer5",  "type": "SIGNER",  "signers": [    {      "email": "mail32@example.com",      "firstName": "John",      "lastName": "Smith",      "id": "Signer5",      "phone": "+15141234567",      "notificationMethods": {        "primary": ["EMAIL", "SMS"]      }    }  ] } ``` Pour une description complète de chaque champ, voir le tableau des charges utiles de demande ci-dessous. #### Charge utile de réponse ```json {  "id": "Signer5",  "data": null,  "specialTypes": [  ],  "emailMessage": null,  "attachmentRequirements": [  ],  "locked": false,  "reassign": false,  "index": 0,  "signers": [    {      "group": null,      "language": "en",      "signature": null,      "id": "Signer5",      "delivery": {        "provider": false,        "email": false,        "download": false      },      "auth": {        "scheme": "NONE",        "challenges": [        ]      },      "knowledgeBasedAuthentication": null,      "data": null,      "title": "",      "company": "",      "email": "mail32@example.com",      "firstName": "John",      "lastName": "Smith",      "external": null,      "updated": "2017-11-16T16:53:01Z",      "phone": "",      "professionalIdentityFields": [      ],      "userCustomFields": [      ],      "address": null,      "created": "2017-11-16T16:53:01Z",      "name": "",      "specialTypes": [      ]    }  ],  "name": "Signer5",  "type": "SIGNER" } ``` ### Mise à jour d’un signataire existant Pour mettre à jour un signataire existant (rôle), créez d’abord une charge utile avec les mises à jour que vous souhaitez effectuer, puis utilisez les exemples de requêtes ci-dessous pour effectuer vos mises à jour. Utilisez le roleid que vous avez assigné dans la demande précédente. Si vous n’avez pas attribué de roleid, un ID généré aléatoirement sera attribué par OneSpan Sign. #### Requête HTTP ```http PUT /api/packages/{packageId}/roles/{roleId} ``` #### En-têtes HTTP ```http Accept: application/json   Content-Type: application/json   Authorization: Basic api_key ``` #### Charge utile de demande ```json {  "type": "SIGNER",  "signers": [    {      "email": "mary.doe@example.com",      "firstName": "Mary",      "lastName": "Doe"    }  ] } ``` ### Charge utile de réponse ```json {  "id": "Signer5",  "data": null,  "specialTypes": [  ],  "emailMessage": null,  "attachmentRequirements": [  ],  "locked": false,  "reassign": false,  "index": 0,  "signers": [    {      "group": null,      "language": "en",      "signature": null,      "id": "Signer5",      "delivery": {        "provider": false,        "email": false,        "download": false      },      "auth": {        "scheme": "NONE",        "challenges": [        ]      },      "knowledgeBasedAuthentication": null,      "data": null,      "title": "",      "company": "",      "email": "mary.doe@example.com",      "firstName": "Mary",      "lastName": "Doe",      "external": null,      "updated": "2017-11-16T16:53:01Z",      "phone": "",      "professionalIdentityFields": [      ],      "userCustomFields": [      ],      "address": null,      "created": "2017-11-16T16:53:01Z",      "name": "",      "specialTypes": [      ]    }  ],  "name": "Signer5",  "type": "SIGNER" } ``` Pour une description complète de chaque champ, voir le tableau des charges utiles de demande ci-dessous. ### Suppression des signataires d’une transaction Pour retirer un signataire, vous effectuez une requête DELETE à l’URI suivante : #### Requête HTTP ```http DELETE /api/packages/{packageId}/roles/{signerId} ``` #### En-têtes HTTP ```http Accept: application/json   Content-Type: application/json   Authorization: Basic api_key ``` ### Résultats Après avoir exécuté votre code, si vous vous connectez à OneSpan Sign et que vous naviguez vers votre forfait, vous verrez votre signataire dans votre transaction. ### Table des charges utiles de requêtes | Propriété | Type | Modifiable | Obligatoire | Par défaut | Valeurs d’échantillonnage | | --- | --- | --- | --- | --- | --- | | id | Corde | Oui | Non | N/D | Signer5 | | Réaffectation | Booléen | Oui | Non | faux | vrai / faux | | Nom | Corde | Oui | Non | N/D | Signer5 | | id | Corde | Oui | Non | N/D | Signer5 | | Type | Corde | Oui | Non | SIGNATAIRE | SIGNATAIRE / EXPÉDITEUR | | Signataires | | | | | | | Email | Corde | Oui | Non | N/D | mail32@example.com | | Prénom | Corde | Oui | Non | N/D | John | | Nom de famille | Corde | Oui | Non | N/D | Smith | | id | Corde | Oui | Non | N/D | Signer5 | | téléphone | Corde | Oui | Non | N/D | "+15141234567" | | MédulesNotificationT | Objet | Oui | Non | N/D | { « primary » : [ « EMAIL » ] } | | Primaire | Tableau | Oui | Non | N/D | [« SMS »], [« EMAIL »], [« EMAIL », « SMS »] | ## APEX SDK Pour télécharger l’exemple complet de code, consultez notre site [de partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/signer-management-example-apex-sdk) . L’une des opérations les plus fondamentales et fondamentales de OneSpan Sign consiste à inviter les signataires à signer des documents. Ce sujet décrit comment ajouter, mettre à jour et supprimer des signataires d’une transaction. Pour garantir la sécurité de vos transactions, n’utilisez pas d’adresses e-mail factices pour vos destinataires. ### Ajout de signataires à une transaction Pour ajouter un signataire à une transaction existante, vous devez d’abord créer l’objet Signer . Le code suivant créera un objet Signer : ```plaintext ESignLiveAPIObjects.Role role = new ESignLiveAPIObjects.Role(); role.id = 'signer1'; role.signers = sdk.createRolesSigner('John', 'Smith', 'signer@example.com', 'CEO', 'ABC Bank'); sdk.helper.createRole(packageId, role); ``` Une fois l’objet Signer créé, trouvez le PackageId qui vous est retourné lors de la création de la transaction et utilisez le client OneSpan Sign pour ajouter votre signataire. Le code suivant le fera ainsi : ```plaintext ESignLiveAPIObjects.Role retrievedRole = sdk.getRole(packageId, 'signer1'); ``` Pour des informations sur la mise à jour des méthodes d’authentification utilisées pour les transactions, voir [Authentification des signataires](/v1/docs/fr/authenticating-signers#java-sdk). ### Mise à jour d’un signataire existant Pour mettre à jour un signataire existant, il suffit de modifier l’un de vos attributs de Signer en récupérant ce signataire. Tous les attributs, à l’exception de RoleID, peuvent être modifiés. Le code suivant le fera ainsi : ```plaintext retrievedRole.signers.get(0).firstName = 'changed firstname'; retrievedRole.signers.get(0).lastName = 'changed lastname'; retrievedRole.signers.get(0).email = 'changed@example.com'; ``` Ensuite, trouvez le PackageId dans lequel vous souhaitez changer ce signataire et utilisez le SDK OneSpan Sign pour le mettre à jour. ```plaintext sdk.updateRole(packageId,'signer1',retrievedRole); ``` ### Suppression des signataires d’une transaction Pour retirer un signataire d’une transaction, il suffit d’appeler la fonction deleteRole avec la chaîne packageID et roleId . ```plaintext sdk.helper.deleteRole(packageId, 'signer1'); ``` #### Résultats Après avoir exécuté votre code, si vous vous connectez à OneSpan Sign et que vous naviguez vers votre forfait, vous verrez votre signataire dans votre transaction.