--- title: "Créer une transaction" slug: "create-transaction" updated: 2025-10-29T15:50:37Z published: 2025-10-29T15:53:13Z canonical: "docs.onespan.com/create-transaction" --- > ## 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. # Créer une transaction Les transactions sont la principale ressource de la vérification d’identité OneSpan (voir aussi [Transaction model](/v1/docs/transaction-model)). Cette API crée et démarre l’exécution d’une nouvelle transaction : - Créez des transactions avec des documents, des signatures, des signataires et une instance du flux de travail prédéfini. - Créez des transactions avec des modèles de documents prédéfinis. - Créez des transactions en fournissant des métadonnées supplémentaires qui seront conservées à titre de preuve électronique. - Créez des transactions avec une instance d’un flux de travail prédéfini pour demander des vérifications de validation d’identité à exécuter via la vérification d’identité OneSpan. - Créez des transactions qui nécessitent le consentement implicite ou explicite de l’utilisateur. Pour obtenir un exemple de demande, reportez-vous à la [Example request with explicit consent](/v1/docs/create-transaction#example-requests). Pour la configuration du consentement, reportez-vous à la [Transaction model](/v1/docs/transaction-model). > Le nombre d’accords ne peut pas dépasser une taille totale de 50 Mo, et la taille d’un seul accord ne doit pas dépasser 10 Mo. ## Syntaxe ```http PUT /api/transaction/ ``` ## Exemples ### Exemples de demandes ```http PUT api/transaction/ HTTP/1.1 Host: onespan.com Accept: application/json, text/javascript {  "tenant_id":"5e52d7b8-8b18-41a4-9187-d4ce75af6815",  "workflow_id":"80b601c9-f102-4761-9eaa-90ba8fcb58b6",  "urlSetKey":"default",  "brand_id":"a089f718-f12d-4b13-b82e-e1d8b324337d",  "language": "english",  "opaque_id": "WorkflowExternalMitAtPwd=1234",  "configuration": {    "redirects": [      {        "id": "REDIRECT_DOCID_PASS",        "url": "https://www.overriddenUrl.com/?user={{userRole}}&transaction={{transactionId}}&opaqueId={{opaqueId}}"      }    ]  },  "users"[...],  "documents"[...] } ``` #### Exemple de demande avec consentement explicite ```http PUT api/transaction/ HTTP/1.1 Host: onespan.com Accept: application/json, text/javascript {  "tenant_id":"5e52d7b8-8b18-41a4-9187-d4ce75af6815",  "workflow_id":"80b601c9-f102-4761-9eaa-90ba8fcb58b6",  "urlSetKey":"default",  "brand_id":"a089f718-f12d-4b13-b82e-e1d8b324337d",  "language": "english",  "opaque_id": "WorkflowExternalMitAtPwd=1234",  "configuration": {    "redirects": [      {        "id": "REDIRECT_DOCID_PASS",        "url": "https://www.overriddenUrl.com/?user={{userRole}}&transaction={{transactionId}}&opaqueId={{opaqueId}}"      },      "consent": {        "explicit": true,        "text": "I agree to the Terms and Conditions consent."      }    ]  },  "users"[...],  "documents"[...] } ``` ### Exemple de réponse ```http HTTP/1.1 200 OK Vary: Accept Content-Type: application/json {  "id":"dcaad720-d1e9-47ba-a76b-a6370ef0373b",  "status":"new",  "created":"2017-04-23T18:25:43.511Z",  "tokens": [...],  ... } ``` ### En-têtes Les en-têtes suivants sont inclus dans la demande et la réponse : #### En-têtes de requête - [Accepter](https://tools.ietf.org/html/rfc7231#section-5.3.2) : le type de contenu de la réponse dépend de l’en-tête Accepter . - [Autorisation](https://tools.ietf.org/html/rfc7235#section-4.2) : jeton OAuth/JWT à authentifier. #### En-têtes de réponse - [Type de contenu](https://tools.ietf.org/html/rfc7231#section-3.1.1.5) : application/json ### Codes d’état

Codes d’état

Code d’état

Nom

Description

200

D’ACCORD

Aucune erreur.

400

Mauvaise demande

Les données de transaction ne sont pas valides.

401

Non autorisée

Jeton non valide.

403

Interdit

Le jeton n’accorde pas de droits de création de transaction.

500

Erreur de serveur interne

Erreur de serveur ou d’application.