Paramètres d’opération pour les prêts hypothécaires

OneSpan Sign a créé une solution hypothécaire numérique qui permet de stocker une note électronique d’une transaction hypothécaire dans un coffre-fort numérique. Pour une transaction donnée, OneSpan Sign met en coffre-fort une seule note électronique en format de document SMART .

Certains paramètres de l’API REST associés à une transaction OneSpan Sign peuvent spécifier quel document doit être mis en chambre forte et dans quelle organisation et dans quel coffre-fort il doit être stocké. Après avoir été mis en chambre forte, le document SMART original est supprimé de la base de données de OneSpan Sign.

Les modèles de documents intelligents que OneSpan Sign utilise pour les transactions impliquant des prêts hypothécaires prennent en charge les sections ARC du modèle. Cette fonctionnalité est exigée par la Federal Home Loan Mortgage Corporation des États-Unis (également connue sous le nom de Freddie Mac).

La création d’une transaction ou d’un modèle à l’aide de l’API REST implique toujours certains paramètres standard (voir Signer Experience Settings.

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

Chaque fois qu’une tentative de dépôt électronique de documents dans un coffre-fort eOriginal échoue, OneSpan Sign envoie une notification à l’expéditeur de la transaction associée au moyen d’un événement de rappel. Une fois que l’effort de stockage d’un document souffre d’une erreur non récupérable, OneSpan Sign envoie à l’expéditeur un e-mail concernant l’échec. Le template de cet e-mail ne peut pas être personnalisé.

Utilisation d’un coffre-fort eOriginal pour les transactions hypothécaires numériques

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

Pour demander à OneSpan Sign de stocker une note électronique dans un coffre-fort eOriginal, les intégrateurs doivent ajouter les deux champs suivants au champ de data la transaction :

• enote_data_section

• enote_vaulting_data

eOriginal stocke une note électronique d’une transaction OneSpan Sign avec le journal d’audit de la transaction.

Si une transaction hypothécaire comporte un document SMART et un ou plusieurs PDF : (1) un coffre-fort eOriginal peut stocker tous ces documents pour la transaction ; (2) La piste d’audit d’eOriginal répertorie tous les événements liés à la transaction et à ses multiples documents.

enote_data_section

Ce champ contient une chaîne XML codée en base64. Cette chaîne contient suffisamment d’informations pour créer le document SMART (y compris la valeur du prêt, les détails de l’emprunteur et l’adresse de la propriété hypothéquée).

Ce champ doit être formaté à l’aide du format XML de la section Data > Main de la spécification MISMO SMART Document 1.02 .

Exemple

Voici un exemple de valeur enote_data_section décodée en Base64 :

<LOAN MISMOVersionIdentifier="2.3">
    <_APPLICATION>
        <LOAN_PRODUCT_DATA>
            <LOAN_FEATURES LienPriorityType="FirstLien" LoanMaturityDate="2030-01-01" OriginalPrincipalAndInterestPaymentAmount="1111.99" ScheduledFirstPaymentDate="2020-01-01">
                <LATE_CHARGE _GracePeriod="15" _Rate="5.000"></LATE_CHARGE>
                <NOTE_PAY_TO _City="Springfield" _PostalCode="99999" _State="MI" _StreetAddress="5555 Example Drive"></NOTE_PAY_TO>
            </LOAN_FEATURES>
        </LOAN_PRODUCT_DATA>
        <MERS MERS_MINNumber="100316200000000012"/>
        <MORTGAGE_TERMS LenderLoanIdentifier="999999999" NoteRatePercent="5.300" OriginalLoanAmount="205000.00" PaymentRemittanceDay="1"></MORTGAGE_TERMS>
        <PROPERTY _City="Greenfield" _County="Green" _PostalCode="00000" _State="CA" _StreetAddress="100 Main Street">
            <PARSED_STREET_ADDRESS _HouseNumber="100" _StreetName="Main Street"></PARSED_STREET_ADDRESS>
        </PROPERTY>
        <BORROWER BorrowerID="N1001" NonPersonEntityIndicator="N" _FirstName="Homer" _LastName="Homeowner" _MiddleName="J." _SSN="555555559" _SequenceIdentifier="1" _UnparsedName="HomerJHomeowner"></BORROWER>
        <BORROWER BorrowerID="N1002" NonPersonEntityIndicator="N" _FirstName="Patricia" _LastName="Purchaser" _MiddleName="P." _SSN="666666669" _SequenceIdentifier="2" _UnparsedName="PatriciaPPurchaser"></BORROWER>
    </_APPLICATION>
    <_CLOSING_DOCUMENTS>
        <EXECUTION _City="Orange" _Date="2020-01-01" _State="CA"></EXECUTION>
        <LENDER _UnparsedName="Sample Banking Group"></LENDER>
    </_CLOSING_DOCUMENTS>
</LOAN>

enote_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 affichés.

Exemple

Voici un exemple de valeur enote_vaulting_data décodée en Base64 :

{
    "version": "Mortgage-2.0",
    "vaultCredentials": {
        "username": "SampleUsername",
        "orgName": "SampleOrganization",
        "apiKey": "ok0Sample0ApiKey0Just0An0Example",
        "endpoint":"testondemand"
    },
    "enote_name": "enote",
    "enote_template_name": "template_3200_enote.xml",
    "document_type": "eNote",
    "loanOriginators": [{
        "nmlsId": "1000000",
        "unparsedName": "Sample Lender Person",
        "nonPersonEntityIndicator": "N"
    },
    {
        "nmlsId": "1323233",
        "unparsedName": "Sample Lender Corp.",
        "nonPersonEntityIndicator": "Y"
    }],
    "customFields": {
        "externalId":"123ABC",
        "customField2":"value"
    },
}

Modèle d’e-mail en cas d’échec du coffre-fort

Si une tentative de stockage d’une note électronique échoue, OneSpan Sign utilise le modèle suivant pour envoyer à l’expéditeur de la transaction associée un courriel 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 d’échec ci-dessus ne sera pas envoyée si l’une des erreurs suivantes se produit dans le vaulting_data champ JSON :