Intégration 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.

URL de base

• UAT : https://transactions.transactional.uat.unico.app/api/public/v1
• Production : https://transactions.transactional.unico.app/api/public/v1

Important

L'intégration de carte de crédit peut être effectuée 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ête	Valeur
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
}

Champ	Type	Requis	Description
identity	object	oui	Informations d'identité de l'utilisateur.
identity.key	string	oui	Type de clé d'identification de l'utilisateur.
identity.value	string	oui	Valeur de la clé d'identification de l'utilisateur.
orderNumber	string	oui	Numé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	string	oui	ID de l'entreprise responsable de la transaction, fourni par Unico.
redirectUrl	string	non	URL 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	object	oui	Informations sur la carte utilisée dans la transaction.
card.binDigits	string	oui	Les 8 premiers chiffres de la carte.
card.lastDigits	string	oui	Les 4 derniers chiffres de la carte.
card.expirationDate	string	non	Date d'expiration de la carte.
card.name	string	oui	Nom du titulaire de la carte — assurez-vous qu'il est correct pour éviter les problèmes d'encodage ou d'approbation.
value	number	non	Valeur maximale garantie.
additionalInfo	object	non	Envoyez cet objet avec processID pour réutiliser les captures biométriques d'autres produits de la plateforme Unico IDCloud.
additionalInfo.processID	string	oui (si additionalInfo est envoyé)	ID du processus de référence de la plateforme IDCloud.

danger

Le 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..."
}

Champ	Description
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.

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ête	Valeur
Authorization	Bearer {token} — un jeton d'accès valide.

200 OK

{
  "status": "processing",
  "hasIdentityChanged": false
}

Champ	Description
status	Statut actuel de la transaction.
hasIdentityChanged	Facultatif. Indique si un échange d'identité s'est produit dans la transaction.

Consultez Énumérations 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 — Intégration de carte de crédit.