Analyser le résultat d'un paiement en cascade

Spécificités d'un paiement en cascade :

Lors du paiement, l’acheteur règle une partie de son achat par Titre-Restaurant puis le solde avec un autre moyen de paiement.

Le paiement sera composé de N séquences détaillées par le champ vads_payment_seq :

  • Toutes les transactions d’un paiement en cascade sont regroupées au sein d’une séquence de paiement.
  • Toutes les transactions d’une séquence de paiement possèdent le même identifiant de transaction, mais un numéro de séquence différent.
  • La première transaction de la séquence possède le numéro 1, la deuxième le numéro 2 et ainsi de suite.

Comment identifier un paiement en cascade?

Lors d'un paiement en cascade, le champ vads_card_brand est valorisé à MULTI.

Détails du champ vads_payment_seq

Toutes les transactions d’un paiement en cascade sont regroupées au sein d’une séquence de paiement.

Toutes les transactions d’une séquence de paiement possèdent le même identifiant de transaction, mais un numéro de séquence différent. La première transaction de la séquence possède le numéro 1, la deuxième le numéro 2 et ainsi de suite.

Le champ vads_payment_seq (format JSON) décrit la séquence de paiement en cascade. Il contient les éléments :

  • "trans_id" : identifiant de la transaction reçu dans le champ vads_trans_id du formulaire de paiement.
  • "transactions" : tableau des transactions de la séquence.

Remarque : les transactions annulées et refusées sont également présentes dans le tableau.

Chaque transaction de la séquence contient les éléments suivants :

Nom du paramètre Description
amount

Montant de la séquence de paiement.

operation_type

Opération de débit.

auth_number

Numéro d'autorisation.

Ne sera pas retourné si non applicable au moyen de paiement concerné.

Exemple : 949478

auth_result Code retour de la demande d'autorisation.
  • Pour un paiement Titre-Restaurant consulter la liste des valeurs dans le chapitre suivant.
  • Pour un paiement par carte bancaire, consultez la liste des valeurs du champ vads_auth_result dans le Guide d'implémentation - API Formulaire.
  • Pour les autres moyens de paiement, consultez la documentation d'intégration correspondante.
capture_delay Délai avant remise (en jours).

Si le champ vads_capture_delay n'est pas transmis dans la demande de paiement, c'est le délai configuré dans le paramétrage de la boutique qui s'applique.

Consultez le chapitre Informations techniques pour vérifier si des restrictions s'appliquent pour ce moyen de paiement.

card_brand

Code du moyen de paiement utilisé.

Exemples:

  • APETIZ pour un paiement par carte Apetiz.
  • SODEXO pour un paiement par carte Sodexo.
  • CHQ_DEJ pour un paiement par carte Chèque-Déjeuner.
  • VISA pour un paiement par carte Visa,
  • MASTERCARD pour un paiement par carte Mastercard
  • CB pour un paiement par carte CB.

Se référer au Guide d'implémentation - API Formulaire pour visualiser la liste complète des valeurs du champ vads_card_brand.

card_number Numéro du moyen de paiement ou identifiant du compte utilisé pour le paiement.
expiry_month Mois d'expiration du moyen de paiement.

Ne sera pas retourné si non applicable au moyen de paiement concerné.

expiry_year Année d'expiration du moyen de paiement.

Ne sera pas retourné si non applicable au moyen de paiement concerné.

payment_certificate Certificat de paiement.

Ne sera pas retourné si non applicable au moyen de paiement concerné.

contract_used Numéro de contrat utilisé pour le paiement.
identifier Alias associé à un moyen de paiement.

Ne sera pas retourné si non applicable au moyen de paiement concerné.

identifier_status Présent uniquement si l’action demandée correspond à la création ou à la mise à jour d'un alias.
Valeurs possibles:
Valeur Description
CREATED

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

L'alias (ou RUM pour un paiement SEPA) est créé avec succès.

NOT_CREATED

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

L'alias (ou RUM pour un paiement SEPA) n'est pas créé et n'apparaîtra pas dans le Back Office Expert.

UPDATED L'alias (ou RUM pour un paiement SEPA) est mis à jour avec succès.
NOT_UPDATED L'alias (ou RUM pour un paiement SEPA) n'a pas été mis à jour.
ABANDONED

Action abandonnée par l'acheteur (débiteur).

L'alias (ou RUM pour un paiement SEPA) n'est pas créé et n'apparaîtra pas dans le Back Office Expert.

presentation_date

Date de remise en banque souhaitée (au format ISO-8601).

Exemple: 2020-04-08T14:56:48Z

trans_id Numéro de transaction.
ext_trans_id Référence de la transaction chez l'acquéreur.

Ne sera pas retourné si non applicable au moyen de paiement concerné.

trans_uuid Référence unique générée par la plateforme de paiement suite à la création d'une transaction de paiement.

Offre une garantie d'unicité pour chaque transaction

sequence_number Numéro de séquence.
trans_status Statut de la transaction.
  • Pour un paiement Conecs, consultez le chapitre Traiter les données de la réponse pour obtenir la liste des statuts possibles.
  • Pour un paiement par carte bancaire, consultez la liste des valeurs du champ vads_trans_status dans le Guide d'implémentation - API Formulaire.
  • Pour les autres moyens de paiement, consultez la documentation d'intégration correspondante.
extra_result Code numérique du résultat des contrôles de risques.

Ne sera pas retourné si non applicable au moyen de paiement concerné.

Se référer au Guide d'implémentation - API Formulaire pour visualiser la liste complète des valeurs du champ vads_extra_result.