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.
| ||||||||||||
| 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:
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 :
| ||||||||||||
| 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.
| ||||||||||||
| 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. |