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

L'url de notification instantanée contiendra notamment les informations ci-dessous :

Identifiez le résultat du paiement en récupérant la valeur du champ vads_trans_status.

Valeur	Description
AUTHORISED	La transaction est acceptée et sera remise en banque automatiquement à la date prévue.
CAPTURED	Présenté La transaction est remise en banque.
CANCELLED	Annulé Annulation par l'acheteur, l'acquéreur ou par la plateforme.
REFUSED	Refusé
ABANDONED	Paiement abandonné par l’acheteur. La transaction n’est pas créée et n’est donc pas visible dans le Back Office Expert.

Identifiez le mode d'autorisation en récupérant la valeur de vads_auth_mode

Nom du champ	Description	Valeur
vads_auth_mode	Mode d’autorisation	Seule la valeur FULL est possible. Autorisation du montant total de la transaction. Valeur utilisée dans le cas d’un paiement comptant, 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.

Nom du champ

Description

Valeur

vads_auth_mode

Mode d’autorisation

Seule la valeur FULL est possible.

Autorisation du montant total de la transaction.

Valeur utilisée dans le cas d’un paiement comptant, 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.

Sauvegardez le montant et la devise utilisée. Pour cela, récupérez les valeurs des champs suivants:

Tableau 1. Champs pour analyser le montant et 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.

Sauvegardez la valeur du champ vads_result pour connaître l'état de la transaction.

Les valeurs possibles sont décrites dans le tableau suivant. Elles sont toujours les mêmes quelque soit le moyen de paiement. En cas d'échec, vous pouvez également consulter la valeur de vads_auth_result pour obtenir des informations complémentaires sur le motif de l'échec.

Valeur	Description
00	Action réalisée avec succès.
02	Le marchand doit contacter la banque du porteur. Déprécié.
05	Action refusée.
17	Annulation de l'acheteur
30	Erreur de format de la requête. A mettre en rapport avec la valorisation du champ vads_extra_result.
96	Erreur technique.

Récupérez la valeur de vads_presentation_date pour connaître la date de remise en banque.
Nom du champ Description Valeur

vads_presentation_date Date de remise en banque
Une transaction PostFinance est toujours présentée à J+1.
Récupérez la valeur de vads_payment_config pour connaître le type de paiement possible.
Nom du champ Description Valeur

vads_payment_config Type du paiement SINGLE.
Enregistrez le type de carte utilisé pour le paiement en récupérant la valeur du champ vads_card_brand.
Les valeurs possibles :
- POSTFINANCE
  PostFinance Card
- POSTFINANCE_EFIN
  PostFinance e-finance
Enregistrez le numéro du contrat associé à la transaction en récupérant la valeur du champ vads_contract_used.

Nom du champ	Description	Valeur
vads_presentation_date	Date de remise en banque	Une transaction PostFinance est toujours présentée à J+1.

Nom du champ	Description	Valeur
vads_payment_config	Type du paiement	SINGLE.

Remarque

Pour connaître le résultat de la demande d'autorisation, sauvegardez la valeur du champ vads_auth_result.

Cette valeur est renvoyée et donnée à titre informatif et dépend exclusivement du moyen de paiement.

Cette information est également disponible dans votre Back Office Expert. Pour la visualiser, affichez le détail d'une transaction. Dans les informations liées à l'autorisation, le détail du retour est affiché (code et libellé).

La liste complète des codes renvoyés est consultable dans le tableau ci-dessous. Vous pouvez contacter l'équipe support pour plus de détails.

Nom du champ	Description	Valeur
vads_auth_result	Codes retour de la demande d'autorisation	Les valeurs possibles sont : 00 : autorisation acceptée 101 : format invalid 102 : limite du retrait dépassée 103 : identifiant marchand inconnu 104 : transaction refusée par le marchand 105 : identifiant PSP inconnu 106 : transaction refusée par PSP 107 : une transaction existe déjà avec le même identifiant 108 : authorisation inacceptée pour raison inconnue 109 : acquéreur indisponible 110 : problème de timeout chez l'acquéreur 111 : problème technique survenu 112 : acquéreur momentément indisponible, il faut ressayer 113 : transaction déjà en cours d'annulation, impossible de revenir en arrière 114 : problème de timeout chez PSP

Catégories

Tags

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