Page tree
Skip to end of metadata
Go to start of metadata

Contenu :

Les types de paiement et opérations


Le principe

L'annulation peut vous être utile pour un paiement autorisé mais que vous ne souhaitez pas valider.

Par exemple, si un article est en rupture de stock vous pouvez soit annuler le paiement dans sa totalité, soit effectuer une annulation partielle du montant de l'article indisponible.

De cette manière, l'annulation totale ou partielle d'un paiement réalisé par carte de crédit libérera l'encours et le consommateur se verra restituer sa capacité à procéder à d'autres paiements. Dans le cas d'une carte prépayé, seul l'annulation totale peut être effectuée pour redresser la balance.

Pour réaliser une annulation de la demande d'autorisation, le commerçant doit utiliser le web service doReset depuis son système d'information.

Vous pouvez uniquement annuler les paiements capturés dans la journée avant l'envoi du fichier de remise à l'acquéreur et/ou au partenaire.

Passée cette échéance, l'annulation sera refusée avec le code 01917 "cette transaction n'est pas annulable". Vous devrez réaliser une demande de remboursement en appelant le web service doRefund.


Les types d'opérations concernées sont :

  • L'annulation partielle des paiements à l'expédition ;
  • L'annulation totale des paiements par portefeuille électronique ;
  • L'annulation totale des paiements à la commande, l'expédition, différé, récurrent et n fois avant la remise à l'acquéreur/partenaire ;
  • L'annulation totale d'un remboursement.


Règles de fonctionnement avant l'envoi du fichier de remise : 

  • Pour une autorisation simple (code action = 100), vous pouvez effectuer une annulation partielle ou totale.
  • Pour une autorisation + validation (code action = 101), vous ne pouvez réaliser qu'une annulation totale.


Les moyens de paiements concernés par l'annulation :

 Voir la liste.
Annulation totaleAnnulation partielle

Tous les moyens de paiement proposés par Payline sauf :

  • AMEX-REC BILLING
  • AMEX-ONE CLICK
  • NEOSURF
  • IDEAL
  • PRZELEWY24
  • GIROPAY
  • SOFORT
  • YANDEX
  • YAPITAL
  • ANCV
  • BOLETO
  • POSTFINANCE
  • BANK_TRANSFER
  • LEETCHI
Seul CB/MC/VISA, MC/VISA et Amex sont compatibles

La procédure d'annulation automatique ne prends pas en charge l’annulation partielle.


Les étapes : 

  1. Le commerçant réalise une annulation depuis son système d'information en appelant le service doReset ;
  2. Payline réalise l’annulation de la demande d'autorisation ;
  3. Le paiement n'est pas réalisé, et l'opération n’apparaît pas le fichier des paiements.


Comment intégrer

L'annulation avec le web service

Vous devez utiliser le service doReset avec la version et l'identifiant de la transaction à annuler :

Exemple d'appel du webservice "doReset"

This element is the request for the doReset method

<sequence>

<element name="version" nillable="false" type="xsd:string"/>

<element name="transactionID" nillable="false" type="xsd:string"/>

<element name="comment" nillable="true" type="xsd:string"/>

<element name="media" nillable="true" type="xsd:string"/>

<element name="amount" nillable="true" type="xsd:string"/>

</sequence>

Liste des champs obligatoires :

Demande d'annulation
doResetRequestdoResetResponse
ElémentsValeursElémentsValeurs
version18result.code00000
transactionIDL'identifiant de la transactionresult.shortmessageACCPTED
amountSeulement dans le cas d'une annulation partielle (exprimé en centièmes, 1€ = 100)result.longmessageTransaction approved


transactionIDL'identifiant de la transaction

Les codes de retour :

Le service Web renvoie :

  • Un paiement est accepté, Payline renvoie le code retour à la valeur 00000.

  • L'erreur 01915 de type ERROR, si l'opération d'annulation n'est pas autorisée.
  • L'erreur 01917 de type ERROR, si l'opération n'est pas annulable pour le partenaire ou l'acquéreur.
  • L'erreur 02603 de type ERROR, si l'opération n'est pas annulable pour Payline.
  • L'erreur 02601 de type ERROR, si vous réalisez une annulation partielle sur une autorisation + validation au lieux d'une autorisation simple.

Voir l'ensemble des codes retour.

Les rapports

Les transactions de type annulation sont visibles en temps réel dans le centre administration Payline et dans le fichier des transactions.