--- title: Transactions de paiement description: Référence de l'API REST pour créer des transactions de paiement, vérifier leur statut, récupérer les preuves et renvoyer des notifications dans Vérification sans carte présente. canonical: https://developer.unico.io/fr/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/payment-transactions locale: fr generated_by: markdown-export --- - [/fr/](/fr/) - Solutions régionales - [Vérification sans carte présente](/fr/dual-api/developers/regional-solutions/card-not-present-verification) - [Intégration](/fr/dual-api/developers/regional-solutions/card-not-present-verification/integration/overview) - [API](/fr/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis) - [Référence API](/fr/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference) - Transactions de paiement **Sur cette page# Transactions de paiement ### Avant de commencer​ Vos requêtes API sont authentifiées à l'aide d'un jeton d'accès. Toute requête qui n'inclut pas un jeton d'accès valide renverra une erreur. Pour en savoir plus, consultez [Authentification](/fr/developers/regional-solutions/card-not-present-verification/integration/authentication). URL de base **UAT** : `https://transactions.transactional.uat.unico.app/api/public/v1` **Production** : `https://transactions.transactional.unico.app/api/public/v1` ### Créer une transaction​ `POST /credit/transaction` — crée une nouvelle transaction. dangerPour garantir une meilleure conversion, créez la transaction **seulement après** avoir terminé toute pré-authentification ou validation susceptible de finaliser l'opération avant l'expérience Vérification sans carte présente. dangerLe champ `orderNumber` doit être rempli avec le numéro de commande **unique** de cet achat dans le système e-commerce — utiliser un ID transactionnel distinct est incorrect. Le réutiliser peut entraîner une faible conversion (le numéro de commande aide l'utilisateur final à terminer le flux) et des erreurs API telles que `replicated transaction` si le même numéro de commande, CPF, BIN et les 4 derniers chiffres sont utilisés. En-têtes En-têteValeur`Authorization``Bearer {token}` — un jeton d'accès valide. Corps ``` { "identity": { "key": "cpf", "value": "12345678900" }, "orderNumber": "order-98765", "company": "company-id", "redirectUrl": "https://yourapp.com/checkout/return", "card": { "binDigits": "12345678", "lastDigits": "1234", "expirationDate": "12/2028", "name": "John Doe" }, "value": 199.90, "mainContacts": [ { "key": "phone", "value": "5543999999999" } ], "additionalInfo": { "externalUserID": "YOUR_EXTERNAL_USER_ID" }} ``` ChampTypeRequisDescription`identity`objectouiDonnées d'identification de l'utilisateur.`identity.key`stringouiType de clé d'identification de l'utilisateur. `cpf` est recommandé — taux de conversion plus élevé.`identity.value`stringouiValeur de la clé d'identification de l'utilisateur, sans points ni tirets.`orderNumber`stringouiNuméro de commande associé à la transaction. Utilisé comme index dans le portail et comme clé étrangère entre votre système et Vérification sans carte présente.`company`stringouiID de l'entreprise responsable de la transaction, fourni par Unico.`redirectUrl`stringnonURL vers laquelle rediriger l'utilisateur après la fin de la transaction (une URL HTTPS pour le web, ou un schéma d'URL pour les applications mobiles natives).`card`objectouiInformations sur la carte utilisée dans la transaction.`card.binDigits`stringouiLes 8 premiers chiffres de la carte.`card.lastDigits`stringouiLes 4 derniers chiffres de la carte.`card.expirationDate`stringnonDate d'expiration de la carte.`card.name`stringouiNom du titulaire de la carte. Envoyez-le correctement, en évitant les problèmes d'encodage — cette donnée est utilisée dans l'expérience utilisateur et la communication.`value`numberouiValeur totale de l'achat.`mainContacts`arraynonListe des contacts principaux (e-mails et/ou téléphones) utilisés pour notifier l'utilisateur, lorsque Vérification sans carte présente est responsable de la notification.`fallbackContacts`arraynonListe des contacts de secours, déclenchés si les tentatives de notification des contacts principaux échouent.`additionalInfo`objectnonEnvoyez cet objet avec `externalUserID` pour activer la [Vérification silencieuse](/fr/developers/regional-solutions/card-not-present-verification/integration/silent-verification) pour cette transaction.`additionalInfo.externalUserID`stringoui (si `additionalInfo` est envoyé)Le même identifiant configuré via `externalUserId` du SDK lors de la collecte des métadonnées de l'appareil. Requis pour déclencher la validation silencieuse — sans lui, la transaction est créée normalement mais suit toujours le flux visuel standard. 200 OK ``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "processing", "link": "https://developers/regional-solutions/card-not-present-verification.unico.app/t/6ab1771e-dfab-4e47-8316-2452268e5481", "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "expiresAt": "2026-07-22T15:30:00Z"} ``` ChampDescription`id`ID de la transaction créée.`status`Statut actuel de la transaction.`link`Lien lié à la transaction.`token`Jeton signé contenant les paramètres nécessaires pour initialiser le SDK web Vérification sans carte présente.`expiresAt`Date et heure d'expiration de la transaction, ISO 8601 (UTC). avertissementSi les validations déterminent que la capture biométrique n'est pas nécessaire, la réponse présente un statut différent et aucun lien de capture n'est généré :``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "fast-inconclusive"} ``` Cela se produit lors de l'utilisation des modules Pre ou Super Pre pour le Checkout, conformément à la [Fonctionnalité](/fr/developers/regional-solutions/card-not-present-verification/about-idpay/feature). remarqueSi `additionalInfo.externalUserID` a été envoyé et que la transaction est approuvée silencieusement, la réponse omet également le lien de capture :``` { "id": "6ab1771e-dfab-4e47-8316-2452268e5481", "status": "approved"} ``` Consultez [Vérification silencieuse](/fr/developers/regional-solutions/card-not-present-verification/integration/silent-verification) pour le flux complet, y compris la configuration du SDK et les exigences de timing. Pour les réponses d'erreur, consultez [Erreurs — Création de transaction](/fr/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#cr%C3%A9ation-de-transaction). ### Obtenir le statut de la transaction​ `GET /credit/transactions/{transaction_id}` — vérifie le statut actuel d'une transaction spécifique. En-têtes En-têteValeur`Authorization``Bearer {token}` — un jeton d'accès valide. 200 OK ``` { "status": "processing"} ``` ChampDescription`status`Statut actuel de la transaction. Consultez [Énumérations](/fr/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated) pour tous les statuts possibles. Pour optimiser les performances, implémentez le Webhook plutôt que d'interroger ce point de terminaison en continu. Pour les réponses d'erreur, consultez [Erreurs — Obtenir le statut de la transaction](/fr/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#obtenir-le-statut-de-la-transaction). ### Obtenir le dossier probatoire de la transaction​ `GET /credit/transactions/{transaction_id}/probative` — récupère le dossier probatoire d'une transaction spécifique. avertissementLe dossier probatoire ne peut être généré que pour les transactions **approuvées**. dangerLe lien renvoyé pour le dossier probatoire est valide pendant **cinq minutes** après son obtention — ne le sauvegardez pas, utilisez-le pour télécharger le dossier probatoire immédiatement. En-têtes En-têteValeur`Authorization``Bearer {token}` — un jeton d'accès valide. 200 OK ``` { "link": "https://unico.io/probative.pdf"} ``` ChampDescription`link`URL du fichier probatoire. Pour les réponses d'erreur, consultez [Erreurs — Récupération du dossier probatoire de la transaction](/fr/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#r%C3%A9cup%C3%A9ration-du-dossier-probatoire-de-la-transaction). ### Renvoyer la notification de transaction​ `POST /credit/transactions/{transaction_id}/notify` — renvoie les notifications par e-mail et/ou téléphone pour une transaction spécifique. remarqueIl est également possible de configurer le renvoi de notification via le portail, sans l'implémenter via l'API. Parlez à votre point de contact projet pour comprendre les possibilités. En-têtes En-têteValeur`Authorization``Bearer {token}` — un jeton d'accès valide. Corps ``` { "phone": "NOTIFICATION_PHONE", "email": "NOTIFICATION_EMAIL"} ``` ChampTypeRequisDescription`phone`stringouiNuméro de téléphone auquel envoyer la notification.`email`stringouiAdresse e-mail à laquelle envoyer la notification. 200 OK ``` { "id": "b50ee24c-71eb-4a5d-ade1-41c48b44c240", "link": "https://aces.so/example"} ``` ChampDescription`id`ID unique de la notification générée.`link`Lien généré pour la notification. Pour les réponses d'erreur, consultez [Erreurs — Renvoi de la notification de transaction](/fr/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#renvoi-de-la-notification-de-transaction).Dernière mise à jour le 8 oct. 2026**