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 :

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

    Remisé

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

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

  3. 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.
  4. 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.
  5. 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.

  6. 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.
  7. 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
  8. Enregistrez le numéro du contrat associé à la transaction en récupérant la valeur du champ vads_contract_used.

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