Paramètres de transaction pour le prêt numérique

OneSpan Sign a créé une solution de prêt numérique qui peut stocker un prêt ou un autre document associé (par exemple, contrat, papier meuble) dans un coffre numérique.

Certains paramètres de l’API REST associés à une transaction OneSpan Sign peuvent spécifier quel document doit être stocké, ainsi que dans quelle organisation et dans quel coffre-fort il doit être stocké. Après que la copie faisant autorité d’un document a été archivée, elle est remplacée dans la base de données de OneSpan Sign soit par une copie non autorisée filigranée (par défaut), soit par un document vierge.

Créer une transaction ou un modèle avec l’API REST implique toujours certains paramètres standards — voir Java SDK.

Si vous souhaitez consulter tous les appels existants, consultez notre spécification interactive Open API. À partir de là, vous pouvez télécharger le fichier YAML de notre API REST, rechercher des points de terminaison spécifiques dans cette API, et même essayer quelques appels vous-même.

Chaque fois qu’une tentative de dépôt électronique de documents dans un coffre eOriginal échoue, OneSpan Sign envoie une notification à l’expéditeur concernant la transaction associée via un événement de rappel. Une fois que l’effort de sauvegarde d’un document subit une erreur irrécupérable, OneSpan Sign envoie un e-mail à l’expéditeur concernant l’échec. Le modèle de cet email ne peut pas être personnalisé.

Utilisation d’un coffre eOriginal pour les transactions de prêt numériques

Actuellement, l’utilisation des signatures optionnelles avec eOriginal n’est pas prise en charge. Par défaut, lors de l’utilisation d’eOriginal, les documents sont enregistrés dès que la dernière signature a été signée par le dernier signataire. Cependant, lorsqu’on utilise des signatures optionnelles, il est possible de réaliser une transaction sans compléter tous les champs de signature. Dans ce cas, le document ne serait pas archivé.

Si vous souhaitez stocker un document dans un coffre-fort eOriginal, la première chose à faire est de demander à notre équipe Support d’activer cette fonctionnalité pour votre compte.

Pour demander à OneSpan Sign de stocker un document dans un coffre-fort eOriginal, les intégrateurs doivent ajouter au champ de la transaction data le vaulting_data champ JSON décrit ci-dessous.

eOriginal sauvegarde un document de prêt issu d’une transaction OneSpan Sign ainsi que le journal d’audit de la transaction.

Depuis la version 11.37 de OneSpan Sign, si une transaction comporte plusieurs documents de prêt : (1) un coffre eOriginal peut stocker tous ces documents pour la transaction ; (2) La trace d’audit d’eOriginal liste tous les événements liés à la transaction et à ses multiples documents.

vaulting_data

Ce champ doit être une chaîne JSON encodée en base 64. Lorsque le champ est décodé, les paramètres du tableau suivant peuvent être consultés.

Les données de sauvegarde ne peuvent pas dépasser 4000 caractères.

Exemple

Voici un exemple de valeur «vaulting_data » décodée en Base64 :

{
        "postRegisterOption":"watermark_doc",
        "vaultTransactionTypeName":"OneSpan Sign eTest",
        "vaultCredentials":{
        "username":"SampleUsername",
        "orgName":"SampleOrganization",
        "apiKey":"ok0Sample0ApiKey0Just0An0Example",
        "endpoint":"previewondemand"
        },
        "documentsToVault":[
        {
        "documentId":"DocumentName01",
        "loanId":"loanId_001",
        "loanAmount":"99999",
        "lender":"ABC Corporation",
        "type":"Loan Contract"
        },
        {
        "documentId":"DocumentName02",
        "loanId":"N/A",
        "loanAmount":"0",
        "lender":"N/A",
        "type":"Ancillary"
        }
        ]
        }

Modèle d’email pour une défaillance de la sauvegarde

Si une tentative de sauvegarde d’un document échoue, OneSpan Sign utilise le modèle suivant pour envoyer un e-mail à l’expéditeur de la transaction associée concernant l’échec.

Ce modèle ne peut pas être personnalisé.

<?xml version="1.0" encoding="UTF-8"?>
        <email-template xmlns="urn:schema.awsng.silanis.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <from>
        <email>support@onespan.com</email>
        <display_name>OSS Support</display_name>
        </from>
        <to>
        <address>
        <email>%USER_EMAIL;</email>
        <display_name>%USER_FIRST_NAME; %USER_LAST_NAME;</display_name>
        </address>
        </to>

        <subject>e-Sign Ceremony Failure Notification</subject>
        <body>
        <content-type>text/html; charset="UTF-8"</content-type>
        <content>

        Dear %USER_FIRST_NAME; %USER_LAST_NAME;,<br/>
        <br/>
        An error has occurred for your package: <br/>
        <br/>
        %NOTIFICATION_MESSAGE;<br/>
        <br/>
        Should you have any problem, please contact OSS Support at support@onespan.com
        <br/>
        <br/>

        Thank you for e-signing.<br/>
        <br/>

        OSS Support
        </content>
        </body>
        <priority>1</priority>

        </email-template>
    

La notification de défaillance ci-dessus ne sera pas envoyée si l’une des erreurs suivantes survient dans le vaulting_data champ JSON :