• France
état des services
démonstrations
assistance
FAQContacter le support
Video tutorials
Rechercher
Catégories
Tags
docs.
France
Espagne
Europe (Anglais)
Inde
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
SDK Mobile
Échange de fichiers
Mandats SEPA par API REST
Exemples de code
Moyens de paiement
Modules de paiement
Marketplace
Guides
Back Office Marchand
Back Office Expert
Guides fonctionnels

Paiement par alias

Pour comprendre le résultat, analysez les champs ci-dessous :

Nom du champ Description
vads_page_action Action réalisée.

La valeur retournée est PAYMENT.

vads_trans_status Statut de la transaction.

Les valeurs possibles sont :

  • AUTHORISED

    La demande d'autorisation a été acceptée.

  • AUTHORISED_TO_VALIDATE

    La demande d'autorisation a été acceptée.

    Le marchand doit valider manuellement la transaction.

  • CAPTURED

    La demande d'autorisation a été acceptée.

    Le paiement est visible dans l'onglet "Transactions remisées" du Back Office.

  • WAITING_AUTHORISATION

    Le délai de remise en banque est supérieur à la durée de validité de l'autorisation. La demande d'autorisation pour le montant total n'a pas encore eu lieu.

  • WAITING_AUTHORISATION_TO_VALIDATE

    A valider et autoriser

    Le délai de remise en banque est supérieur à la durée de validité de l'autorisation.

    Une autorisation 1 EUR (ou demande de renseignement sur le réseau CB si l'acquéreur le supporte) a été acceptée.

    Le marchand doit valider manuellement la transaction afin de déclencher la demande d’autorisation et la capture.

  • REFUSED

    La demande d'autorisation a été refusée.

  • ABANDONED

    Opération abandonnée par l'acheteur.

    La transaction n'apparaît pas dans le Back Office Expert.

vads_identifier Identifiant de l'alias à débiter.

La valeur retournée est identique à celle transmise dans la requête.

vads_cust_email Adresse e-mail de l'acheteur associé à l'alias.
vads_site_id Identifiant de la boutique.

La valeur retournée est identique à celle transmise dans la requête.

vads_ctx_mode Mode de fonctionnement.

La valeur retournée (TEST ou PRODUCTION) est identique à celle transmise dans la requête.

Pour connaître le détail du paiement consultez les paramètres ci-dessous :

Informations sur la transaction :

Nom du champ Description
vads_operation_type Type de transaction.

Sa valeur est DEBIT.

vads_occurrence_type Type d'occurrence de la transaction.

Sa valeur est RECURRENT_INTERMEDIAIRE.

vads_amount Montant de la transaction.

La valeur retournée est identique à celle transmise dans la requête.

vads_currency Code de la devise utilisée pour le paiement.
vads_trans_id Identifiant de la transaction.

La valeur retournée est identique à celle transmise dans la requête.

vads_trans_uuid Identifiant unique de la transaction.

Sa valeur est générée par la plateforme de paiement.

vads_initial_issuer_transaction_identifier Identifiant de transaction unique généré par l'émetteur.
vads_contract_used Numéro du contrat associé à la transaction.
vads_auth_mode Type de demande réalisée auprès des serveurs d'autorisation :
  • MARK : correspond à une autorisation de 1 EUR (ou demande de renseignement sur le réseau CB si l'acquéreur le supporte).

    Valeur utilisée également si la durée séparant la date de remise demandée de la date du jour est strictement supérieure à la durée de validité de l'autorisation.

  • FULL : correspond à une autorisation du montant total de la transaction.

    Valeur utilisée si la durée séparant la date de remise demandée de la date du jour est strictement inférieure à la durée de validité de l'autorisation.

vads_auth_number Numéro d'autorisation retourné par le serveur d'autorisation.

Vide si autorisation échouée.

vads_auth_result Code retour de la demande d'autorisation retournée par la banque émettrice.

Voir chapitre Gérer les codes retour de la demande d'autorisation.

Vide si erreur avant autorisation.

vads_risk_control Résultat des contrôles de risque.

Lorsque qu'au moins un contrôle retourne la valeur ERROR, la transaction est refusée.

Consultez la description du champ vads_risk_analysis_result pour plus de détails.

vads_risk_assessment_result

Liste des actions réalisées sur la transaction, suite au déclenchement des règles de gestion de risque avancée.

Les valeurs possibles sont :
Valeurs Description
ENABLE_3DS
  • Le module de risque a demandé une authentification avec interaction du porteur (challenge).
DISABLE_3DS
  • Le module de risque a demandé une authentification sans interaction du porteur (frictionless).
NO_PREFERENCE
  • Le module de risque a demandé une authentification 3DS. Le choix de la préférence est délégué à l'émetteur de la carte.
NO_CHALLENGE_REQUESTED
  • Le module de risque a demandé une authentification sans interaction du porteur (frictionless).
CHALLENGE_REQUESTED
  • Le module de risque a demandé une authentification avec interaction du porteur (challenge).
CHALLENGE_MANDATE
  • Le module de risque a demandé une authentification avec interaction du porteur (challenge) pour des raisons réglementaires.
MANUAL_VALIDATION
  • La transaction est créée en validation manuelle.
  • La remise du paiement est bloquée temporairement pour permettre au marchand de procéder à toutes les vérifications souhaitées.
REFUSE
  • La transaction est refusée.
RUN_RISK_ANALYSIS
  • Appel à un analyseur de risques externe sous condition que le marchand possède un contrat.

    Se référer à la description du champ vads_risk_analysis_result pour identifier la liste des valeurs possibles et leur description.

INFORM
  • Une alerte est remontée.
  • Le marchand est averti qu’un risque est identifié.
  • Le marchand est informé via une ou plusieurs des règles du centre de notification (URL de notification, e-mail ou SMS).

Informations sur le moyen de paiement utilisé :
Nom du champ Remarque
vads_acquirer_network Code du réseau acquéreur.
vads_bank_code Code de la banque émettrice
vads_bank_label Nom de la banque émettrice de la carte utilisé.
vads_bank_product Code produit de la carte utilisée.
vads_card_brand Moyen de paiement utilisé.

Consultez le chapitre Moyens de paiement compatibles pour obtenir la liste des valeurs possibles.

vads_card_country Code pays de la carte utilisée à la norme ISO 3166.
vads_card_number Numéro de carte tronqué/masqué

ou

IBAN et BIC utilisés pour le paiement, séparés par un « _ » dans le cas d’un prélèvement ponctuel.

Le BIC étant optionnel, il peut ne pas être présent

.
vads_expiry_month Mois d’expiration de la carte utilisée.
Il est conseillé d'utiliser cette donnée pour contrôler la date d'expiration de l'alias.
vads_expiry_year Année d’expiration de la carte utilisée.
Il est conseillé d'utiliser cette donnée pour contrôler la date d'expiration de l'alias.

Détails de l'authentification forte :

Nom du champ Remarque
vads_threeds_auth_type Type d’authentification du porteur.
Les valeurs possibles sont :
  • "Vide" si l'acheteur ne s'est pas authentifié correctement,
  • FRICTIONLESS : authentification du porteur sans interaction avec l'ACS. Valeur retournée uniquement en 3DS v2,
  • CHALLENGE : authentification interactive du porteur (saisie OTP ou réponse à une série de questions). Valeur retournée en 3DS v1 et 3DS v2.
vads_threeds_enrolled

Statut de l'inscription du porteur au programme 3D Secure.

Les valeurs possibles sont :
  • Y : Authentification disponible.
  • N : Authentification non disponible
  • U : Statut de l'inscription au programme 3DS inconnu
  • vide: Processus 3DS non réalisé (3DS désactivé dans la demande, marchand non inscrit ou moyen de paiement non éligible au 3DS).
vads_threeds_status Résultat de l’authentification 3D Secure.
Les valeurs possibles sont :
  • Y : Porteur authentifié avec succès.
  • N : Erreur d’authentification du porteur.
  • U : Authentification impossible
  • A : Tentative d’authentification mais authentification non réalisée.
  • vide: Authentification 3DS non réalisée (3DS désactivé dans la demande, porteur non inscrit ou moyen de paiement non éligible au 3DS).

Les champs facultatifs transmis dans la requête sont retournés dans la réponse sans modification de leur valeur.

Nous recrutons
Mentions légales
Charte de Protection des Données Personnelles
25.18-1.11