Traiter les données spécifiques à la réponse d'un paiement MasterPass

Ci-dessous un exemple d'analyse pour vous guider pas à pas lors du traitement des données de la réponse.
  1. Récupérez le résultat du paiement transmis dans le champ vads_trans_status. Sa valeur vous permet de définir le statut de la commande.
    Valeur Description
    AUTHORISED

    La transaction est acceptée et sera remise en banque automatiquement à la date prévue.

    CAPTURED

    Remisé

    La transaction est remise en banque.

    ABANDONED

    Paiement abandonné par l’acheteur.

    La transaction n’est pas créée et n’est donc pas visible dans le Back Office Marchand.

    CANCELLED

    Annulé

    Annulation par l'acheteur, l'acquéreur ou par la plateforme.

    REFUSED

    Refusé

    AUTHORISED_TO_VALIDATE

    A valider

    EXPIRED

    Expirée

    La date d'expiration de la demande d'autorisation est atteinte et le marchand n’a pas validé la transaction. Le porteur ne sera donc pas débité.

  2. Récupérez la référence du paiement transmise dans le champ vads_trans_id.
  3. Récupérez la valeur du champ vads_trans_date pour identifier la date du paiement.
  4. Récupérez la valeur du champ vads_capture_delay pour identifier le nombre de jours avant la remise en banque.
    Ceci vous permettra d'identifier s'il s'agit d'un paiement immédiat ou différé.
  5. Récupérez le montant et la devise utilisée. Pour cela, récupérez les valeurs des champs suivants:
    Tableau 1. Analyse du montant et de la devise utilisée
    Nom du champ Description
    vads_amount Montant du paiement dans sa plus petite unité monétaire.
    vads_currency Code de la devise utilisée pour le paiement.
    vads_change_rate Taux de change utilisé pour calculer le montant réél du paiement (voir vads_effective_amount).
    vads_effective_amount Montant du paiement dans la devise réellement utilisée pour effectuer la remise en banque.
  6. Récupérez la valeur du champ vads_auth_result pour connaître le résultat de la demande d'autorisation.
  7. Récupérez le résultat des contrôles associés à la fraude en identifiant la valeur du champ vads_risk_control. Ce champ est envoyé uniquement si le marchand a:
    • souscrit au service « Aide à la décision »
    • activé au moins un contrôle depuis son Back Office Marchand (menu Paramétrage > Contrôle des risques).
    Il prend comme valeur une liste de valeurs séparées par un « ; » dont la syntaxe est: vads_risk_control = control1=result1;control2=result2
    Les valeurs possibles pour control sont :
    Tableau 2. Liste des contrôles associés à la fraude
    Valeur Description
    CARD_FRAUD Contrôle la présence du numéro de carte de l'acheteur dans la liste grise de cartes.
    SUSPECT_COUNTRY Contrôle la présence du pays émetteur de la carte de l'acheteur dans la liste des pays interdits.
    IP_FRAUD Contrôle la présence de l'adresse IP de l'acheteur dans la liste grise d'IP.
    CREDIT_LIMIT Contrôle la fréquence et les montants d'achat d'un même numéro de carte, ou le montant maximum d'une commande.
    BIN_FRAUD Contrôle la présence du code BIN de la carte dans la liste grise des codes BIN.
    ECB Contrôle si la carte de l'acheteur est de type e-carte bleue.
    COMMERCIAL_CARD Contrôle si la carte de l'acheteur est une carte commerciale.
    SYSTEMATIC_AUTO Contrôle si la carte de l'acheteur est une carte à autorisation systématique.
    INCONSISTENT_COUNTRIES Contrôle si le pays de l'adresse IP, le pays émétteur de la carte de paiement, et le pays de l'adresse de l'acheteur sont cohérents entre eux.
    NON_WARRANTY_PAYMENT Transfert de responsabilité.
    SUSPECT_IP_COUNTRY Contrôle la présence du pays de l'acheteur, identifié par son adresse IP, dans la liste des pays interdits.
    Les valeurs possibles pour result sont :
    Tableau 3. Liste des contrôles associés à la fraude
    Valeur Description
    OK OK.
    WARNING Contrôle informatif échoué.
    ERROR Contrôle bloquant échoué.
  8. Récupérez le type de carte utilisé pour le paiement en identifiant la valeur du champ vads_card_brand.
  9. Vous pouvez enregistrer le type de wallet qui a servi pour le paiement en récupérant la valeur du champ vads_wallet.
    Valeur du champ vads_wallet Type de wallet
    MASTERPASS Masterpass de Mastercard
    PAYPAL Paypal live
    PAYPAL_SBX Paypal Sandbox
    VISA_CHECKOUT Visa Checkout
    PAYLIB Paylib
    Le champ vads_wallet est présent uniquement lorsqu'un wallet est utilisé pour le paiement.
  10. Analysez les champs ci-dessous si vous avez autorisé l'acheteur à sélectionner son adresse de livraison depuis son wallet Masterpass :
    Nom du champ Description
    vads_ship_to_street_number Numéro de rue
    vads_ship_to_street Adresse postale
    vads_ship_to_street2 Deuxième ligne d'adresse.
    vads_ship_to_district Quartier
    vads_ship_to_city Ville
    vads_ship_to_state Etat / Région
    vads_ship_to_zip Code postal
    vads_ship_to_country Pays
    vads_ship_to_phone_num Numéro de téléphone
  11. Récupérez toutes les informations concernant le détail de la commande, le détail de l'acheteur et le détail de la livraison.
    Ces données sont présentes dans la réponse que si elles ont été envoyées dans le formulaire de paiement.
    Leur valeur est identique à celle soumise dans le formulaire.
  12. Procédez à la mise à jour de la commande.