--- title: Onboarding de carte de crédit description: Référence de l'API REST pour valider une carte de crédit et vérifier le statut de validation dans la fonctionnalité d'Onboarding de carte de crédit de 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/credit-card-onboarding 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) - Onboarding de carte de crédit **Sur cette page# Onboarding de carte de crédit ### 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` ImportantL'Onboarding de carte de crédit peut être effectué soit en demandant un selfie à l'utilisateur final et en réalisant l'enregistrement complet, **soit** en réutilisant des captures biométriques issues de processus exécutés par d'autres produits de la plateforme Unico IDCloud : Pour réutiliser des processus générés par d'autres produits IDCloud, indiquez l'ID du processus de référence dans `additionalInfo.processID` ; Le processus de référence utilisé doit avoir été complété il y a **1 heure** maximum. ### Valider la carte de crédit​ `POST /walletid/transaction` — valide une carte de crédit. En-têtes En-têteValeur`Authorization``Bearer {token}` — un jeton d'accès valide. Corps ``` { "identity": { "key": "cpf", "value": "12345678900" }, "orderNumber": "onboarding-98765", "company": "company-id", "redirectUrl": "https://yourapp.com/wallet/return", "card": { "binDigits": "12345678", "lastDigits": "1234", "expirationDate": "12/2028", "name": "John Doe" }, "value": 5000.00, "additionalInfo": { "externalUserID": "YOUR_EXTERNAL_USER_ID" }} ``` ChampTypeRequisDescription`identity`objectouiInformations d'identité de l'utilisateur.`identity.key`stringouiType de clé d'identification de l'utilisateur.`identity.value`stringouiValeur de la clé d'identification de l'utilisateur.`orderNumber`stringouiNuméro associé à l'intégration. 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 une URL de schéma 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 — assurez-vous qu'il est correct pour éviter les problèmes d'encodage ou d'approbation.`value`numbernonValeur maximale garantie.`additionalInfo`objectnonEnvoyez cet objet avec `processID` pour réutiliser les captures biométriques d'autres produits de la plateforme Unico IDCloud, et/ou avec `externalUserID` pour activer la [Vérification Silencieuse](/fr/developers/regional-solutions/card-not-present-verification/integration/silent-verification) pour cette transaction.`additionalInfo.processID`stringnonID du processus de référence de la plateforme IDCloud.`additionalInfo.externalUserID`stringnonLe même identifiant configuré via le `externalUserId` du SDK lors de la collecte des métadonnées de l'appareil. Requis uniquement pour déclencher la validation silencieuse — sans lui, la transaction est créée normalement mais suit toujours le flux visuel standard. 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, et réutiliser des valeurs peut déclencher des erreurs `replicated transaction`. 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..."} ``` ChampDescription`id`ID de la transaction créée.`status`Statut actuel de la transaction.`link`Lien lié à la transaction. Renvoyé uniquement si `additionalInfo.processID` n'est **pas** fourni.`token`Jeton signé pour initialiser le SDK web Vérification sans carte présente. Renvoyé uniquement si `additionalInfo.processID` n'est **pas** fourni. 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. ### Vérifier le statut de validation​ `GET /walletid/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", "hasIdentityChanged": false} ``` ChampDescription`status`Statut actuel de la transaction.`hasIdentityChanged`Facultatif. Indique si un échange d'identité s'est produit dans 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 — Onboarding de carte de crédit](/fr/dual-api/developers/regional-solutions/card-not-present-verification/integration/apis/errors#credit-card-onboarding).Dernière mise à jour le 8 oct. 2026**