---
title: "Modèle de transaction"
slug: "transaction-model"
updated: 2025-10-29T15:50:19Z
published: 2025-10-29T15:53:13Z
canonical: "docs.onespan.com/transaction-model"
---
> ## 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.
# Modèle de transaction
Le modèle de transaction de vérification d'identité OneSpan définit des éléments de données qui contiennent toutes les métadonnées de transaction nécessaires à l'exécution d'un flux de travail d'entente électronique. Le modèle de transaction facilite les actions suivantes :
- Produire les documents d'entente signés
- Recueillir des preuves électroniques
- Produire la piste d'audit et le pack de preuves uniques
Le modèle de transaction de vérification d'identité OneSpan est entièrement défini par des schémas JSON qui peuvent être utilisés pour générer des bibliothèques côté client pour accéder à l'API REST de vérification d'identité OneSpan.
## Propriétés de la transaction
La structure de données de transaction de vérification d'identité OneSpan contient les métadonnées nécessaires à l'exécution d'un flux de travail d'entente électronique et à la collecte de preuves électroniques. Les preuves sont nécessaires pour faciliter la preuve de la conformité et de l'applicabilité.
La structure combine des données de transaction, d'utilisateurs, de documents, d'événements et de session (view_state). La transaction est une ressource de niveau supérieur qui est partagée entre tous les composants de vérification d'identité OneSpan.
[Transaction properties](/docs/fr/transaction-model#Tab_Transaction_properties) répertorie les propriétés de la transaction dans la vérification d'identité OneSpan.
- Chemin d'accès : .../propriétés/transaction
- Type : objet
| **Propriétés de la transaction** |
| --- |
| | | |
| Propriété | Type | Description |
| brand_id | Corde | L'UUID de la marque attribuée à la transaction. Les marques sont définies dans la configuration du locataire. Les locataires peuvent définir et utiliser plusieurs marques pour leurs transactions. Une fois que l'ID de marque est attribué, il ne peut pas être modifié après la création de la transaction. - Longueur maximale : 64 - Longueur minimale : 36 - Modèle: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$ |
| terminé | Corde | La date et l'heure auxquelles une transaction a été effectuée. - Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}.[ 0-9]{3}Z$ - Format par défaut : 2012-04-23T18:25:43.511Z |
| configuration.consentement | Objet | Configuration pour le consentement implicite ou explicite. Dans le cas du consentement explicite, l'utilisateur doit donner son consentement explicite en cochant une case sur la page d'accueil. Pour obtenir la liste des propriétés de consentement , consultez [propriétés configuration.consent](/docs/fr/transaction-model#Tab_consentProperties). Restrictions relatives au consentement : - Le consentement doit être donné dans la même langue que celle définie pour les transactions IDV. - Le texte de consentement peut comporter jusqu'à 2048 caractères. - Le texte peut contenir des URL au format suivant : « J'accepte l' Conditions générales. » L'URL n'est pas sensible à la casse. Pour plus d'informations, consultez [la section Afficher les règles pour le texte de consentement](/v1/docs/transaction-model#display-rules-for-consent-text). |
| configuration.redirections | Tableau | La liste des URL qui remplacent les URL de transfert configurées correspondantes lors de la création de la transaction, à l'aide des valeurs de la transaction en cours de l'utilisateur. Ils peuvent être utilisés pour passer les paramètres suivants : - userRole - transactionId - opaqueId Les URL sont spécifiées avec des paires d'ID et d'URL. Pour obtenir la liste des propriétés de redirection , consultez [propriétés configuration.redirects](/docs/fr/transaction-model#Tab_redirectsProperties). |
| créé | Corde | La date et l'heure de création de la transaction sont en UTC. Motif : ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$ |
| disable_notifications | Booléen | Cette propriété définit si les notifications sont désactivées pour la transaction en cours. Valeur par défaut : false |
| disable_recording | Booléen | Cette propriété définit si l'enregistrement est désactivé pour la transaction en cours. Valeur par défaut : false |
| documents | | Tableau contenant les documents et leurs attributs définis dans la transaction en cours (voir [Document model](/v1/docs/document-model)). Schéma : transaction.schema.3.0.documents.json#/définitions/documents |
| erasure_mark | Corde | Le jour où la transaction doit être supprimée à la demande du client. UTC ne prend désormais en compte que l'année, le mois et le jour. - Motif : ^[0-9]{4}-[0-9]{2}-[0-9]{2}Z$ - Exemple : 2012-04-23Z |
| erasure_mark_request | Corde | UTC : maintenant l'horodatage est en millisecondes. Le moment où la transaction a été marquée ou non marquée pour l'effacement. - Modèle: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2} :[0-9]{2} :[0-9]{2}(\\.[ 0-9]*)? Z$ - Exemple : 2012-04-23T18:25:43.511Z |
| expiry_period | Entier | Nombre de jours avant l'expiration de la transaction. Si elle n'est pas fournie, la valeur par défaut spécifiée dans la configuration du locataire sera utilisée. |
| expiry_timestamp | Corde | La date et l'heure d'expiration de la transaction sont en UTC. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}.[ 0-9]{3}Z$ |
| id | Corde | L'UUID de la transaction. - Longueur maximale : 64 - Longueur minimale : 36 - Modèle: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$ |
| Langue | | Cette propriété définit la langue par défaut des transactions. Il peut être écrasé au niveau de la session. Dans le cadre d'une même transaction, plusieurs sessions interactives peuvent être exécutées dans différentes langues. Schéma : .. /commun/_common.schema.3.0.language.json |
| last_api_request | Corde | Date et heure de la dernière transaction avec une demande d'API. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}.[ 0-9]{3}Z$ |
| last_session_event | Corde | Date et heure du dernier événement d'une session de workflow active. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}.[ 0-9]{3}Z$ |
| opaque_id | Corde | Optionnel. L'ID opaque peut être fourni par l'application cliente et affecté à une transaction. Une fois l'ID opaque attribué, il ne peut pas être modifié après la création de la transaction. L'ID opaque sera inclus dans les données de notification d'événement avec l'ID de transaction. Il peut être utilisé par l'application cliente comme contexte supplémentaire pour le suivi des transactions. - Longueur maximale : 64 - Longueur minimale : 0 - Longueur par défaut : 1234567890 |
| request_ids | Tableau | ID des requêtes asynchrones. Articles: - Type : corde |
| session | | Données de session (voir [Session model](/v1/docs/session-model)). Schéma : transaction.schema.3.0.session.json#/definitions/session |
| statut | Corde | Statut actuel de la transaction. L'état peut être l'un des suivants : - Nouveau - post_processing - terminé - annulé - périmé - erreur Valeur par défaut : new |
| status_changed | Corde | Date et heure auxquelles le statut de la transaction a changé. - Modèle: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2} :[0-9]{2} :[0-9]{2}(\\.[ 0-9]*)? Z$ - Exemple : 2021-01-23T18:25:43.511Z |
| tenant_id | Corde | L'UUID du locataire auquel appartient cette transaction. Lorsque la transaction est créée, le locataire est identifié par le JWT fourni avec la demande de création de transaction. Une fois l'ID de locataire attribué, il ne peut pas être modifié. Par conséquent, les transactions ne peuvent pas être réaffectées entre les locataires. Motif : ^[-w]+$ |
| Jetons | | Tableau contenant les jetons de création de session qui ont été émis pour cette transaction (voir [Token model](/v1/docs/token-model)). Schéma : transaction.schema.3.0.tokens.json#/definitions/tokens |
| urlSetKey | Corde | Clé d'ensemble d'URL utilisée pour récupérer le point de terminaison du locataire. |
| Utilisateurs | | Tableau contenant des informations spécifiant les données d'identité du signataire (voir [User model](/v1/docs/user-model)). Ce tableau contient une liste de ressources où chaque entrée de liste représente des informations sur un seul participant au processus d'e-agreement. Les données contiennent des informations d'identité personnelle, des informations d'adresse et d'autres données qui peuvent être utilisées pour la validation de l'identité en ligne. Schéma : transaction.schema.3.0.users.json#/definitions/users |
| Version | Entier | Version de l'enregistrement de la transaction. Propriété en lecture seule. Valeur par défaut : 0 |
| workflow_id | Corde | UUID du flux de travail affecté à la transaction. Les flux de travail sont définis dans la configuration du locataire. Les locataires peuvent définir et utiliser plusieurs flux de travail pour leurs transactions. Une fois l'ID de flux de travail attribué, il ne peut pas être modifié après la création de la transaction. - Longueur maximale : 64 - Longueur minimale : 36 - Modèle: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$ |
| **Propriétés configuration.consent** |
| --- |
| Propriété | Type | Description |
| explicite | Booléen | Vrai : Le consentement est explicite. Faux : Le consentement est implicite. |
| SMS | Corde | Le message affiché sur la page d'accueil pour le consentement implicite/explicite. |
Propriétés configuration.redirects
Propriété
Type
Description
id
Corde
ID de l'URL de transfert à remplacer.
URL
Corde
L'URL qui remplace l'URL de transfert configurée.
## Afficher les règles pour le texte de consentement
Les règles d'affichage suivantes s'appliquent :
- Les liens au format Text doivent s'ouvrir dans un nouvel onglet du navigateur.
- Les symboles HTML doivent être échappés et s'affichent tels quels.
- Toutes les lignes sont conservées.
| **Afficher les règles pour le texte de consentement** |
| --- |
| Texte de consentement | Affiché sous la forme |
| Veuillez confirmer un consentement . Merci | Veuillez confirmer votre consentement. Merci |
| Veuillez confirmer un consentement . Merci | Veuillez confirmer votre consentement. Merci |
| Veuillez confirmer un consentement . Merci | Veuillez confirmer votre consentement. Merci |
| Veuillez confirmer un consentement . Merci | Veuillez confirmer votre consentement. Merci |
| Veuillez confirmer un consentement . Merci | Veuillez confirmer votre consentement. Merci |
| Veuillez confirmer un consentement . Merci | Veuillez confirmer un consentement . Merci |
| Veuillez confirmer un consentement . Merci | Veuillez confirmer un consentement . Merci |
| Veuillez confirmer un consentement . un de consentement1. Merci | Veuillez confirmer votre consentement. un consentement1. Merci |
## Exemple de demande
```json
{
"workflow_id": "80b601c9-f102-4761-9eaa-90ba8fcb58b6",
"urlSetKey": "default"
"language": "english",
"opaque_id": "WorkflowExternalMitAtPwd=1234",
"brand_id": "a089f718-f12d-4b13-b82e-e1d8b324337d",
"disable_recording": "true",
"disable_notifications": "true",
"configuration": {
"redirects": [
{
"id": "REDIRECT_DOCID_PASS",
"url": "https://www.overriddenUrl.com/?user={{userRole}}&transaction={{transactionId}}&opaqueId={{opaqueId}}"
}
]
"status_changed":"2021-01-23T18:25:43.511Z"
"erasure_mark":"2012-04-23Z"
"erasure_mark_request":"2012-04-23T18:25:43.511Z"
},
"users":[{"...": "..."}],
"tokens": [{"...": "..."}],
"documents": [{"...": "..."}]
"expiry_period": 10
}
```
> Le contenu de cette API contient des éléments de données fournis par nos partenaires et est sujet à des modifications et mises à jour par nos partenaires. Ce contenu peut inclure des erreurs, des omissions, des erreurs techniques ou autres ou des inexactitudes. Nous vous aiderons au mieux de nos capacités, mais veuillez noter que nous ne contrôlons pas entièrement ce contenu.