Développeurs de panneaux OneSpan : Document de consentement ou consentement par défaut - Partie 2

Dans OneSpan Sign, un accord de consentement relatif aux divulgations et signatures électroniques sera automatiquement inclus dans toutes les transactions, et devra être accepté par les signataires avant qu'ils ne puissent accéder au reste des documents.

Cependant, le consentement par défaut défini au niveau du compte ne signifie pas nécessairement que vous ne pouvez pas le personnaliser pour chaque transaction individuelle. Dans ce blog, nous allons vous présenter quelques bonnes pratiques pour manipuler le formulaire de consentement par défaut au niveau de la transaction. Sans plus attendre, commençons !

Supprimer le consentement par défaut

Supposons que votre entreprise possède plusieurs secteurs d'activité dont certaines transactions requièrent un accord de divulgation. Vous pouvez invoquer un appel API/SDK supplémentaire pour supprimer le formulaire de consentement par défaut après l'appel initial de création d'une transaction.

Pour les utilisateurs REST :

Requête HTTP

DELETE /api/packages/{packageId}/documents/default-consent

En-têtes HTTP

Authorization : Basic api_key/ Bearer api_token
Accept : application/json

Pour les utilisateurs du SDK :

SDK Java

eslClient.getPackageService().deleteDocument(packageId, "default-consent") ;

sDK .NET

ossClient.PackageService.DeleteDocument(packageId, "default-consent") ;

Téléchargement du consentement par défaut personnalisé

Dans le dernier blog, nous avons mentionné que vous pouvez contacter notre équipe d'assistance et personnaliser les divulgations électroniques par défaut en mettant à jour les paramètres de votre compte. En outre, il est également possible de télécharger votre consentement par défaut personnalisé pour chaque transaction.

Comme pour la création d'un document accepté uniquement, lorsque vous construisez le JSON de votre transaction, ajoutez un nœud de document avec un identifiant "default-consent" et un index de 0, comme indiqué dans l'exemple ci-dessous. Cela remplacera le consentement par défaut par votre document téléchargé :

Requête HTTP

POST /api/packages

En-têtes HTTP

Authorization : Basic api_key / Bearer access_token
Accept : application/json
Content-Type : multipart/form-data

Chargement de la requête

{
  "roles" : [
    {
      "id" : "Role1",
      "signers" : [
        {
          "email" : "[email protected]",
          "firstName" : "John",
          "lastName" : "Smith",
          "entreprise" : "OneSpan Sign"
        }
      ]
    }
  ],
  "documents" : [
    {
      "id" : "default-consent",
      "name" : "Consentement par défaut",
      "index" : 0,
      "approvals" : []
    },
    {
      "id" : "document1",
      "name" : "Document1",
      "index" : 1,
      "approvals" : [
        {
          "role" : "Role1",
          "fields" : [
            {
              "page" : 0,
              "top" : 100,
              "sous-type" : "FULLNAME",
              "height" : 50,
              "left" : 100,
              "width" : 200,
              "type" : "SIGNATURE"
            }
          ]
        }
      ]
    }
  ],
  "nom" : "Exemple de paquet",
  "consentement" : "default-consent",
  "status" : "SENT"
}

Remarque :

L'attribut "consent" fait référence à l'identifiant du document du consentement par défaut. Bien que vous ayez la possibilité de spécifier différents identifiants de document, il est conseillé de laisser l'attribut par défaut.

Utilisation des modèles

Les deux astuces ci-dessus sont idéales pour supprimer ou personnaliser le consentement par défaut pour une seule transaction. Si vous souhaitez éviter cette complexité pour les transactions nouvellement créées, vous pouvez simplement créer un modèle et appliquer les meilleures pratiques décrites ci-dessus à votre modèle. Dans ce cas, toutes les transactions ultérieures créées à partir de ce modèle hériteront du consentement par défaut mis à jour.

Ceci conclut le blog d'aujourd'hui. Nous avons appris à personnaliser le formulaire de consentement par défaut pour une transaction donnée et à utiliser un modèle pour appliquer rapidement les paramètres et raccourcir le processus de création de la transaction. Si vous avez des questions concernant ce blog ou tout autre sujet relatif à l'intégration de OneSpan Sign dans votre application, visitez les forums de la communauté des développeurs. Vos commentaires nous intéressent !