support
Retour à la documentation
Rechercher
Catégories
Tags
Paramètres principauxtout montrer
uuid
requis
options générales
amount
currency
comment
options relatives à la méthode de paiement
transactionOptions
cardOptions
manualValidation
captureDelay
mid
Testez moi
Documentation

Web service Transaction/Refund

L'appel aux Web Services requiert une authentification HTTP Basic Authentication. Plus d'infos : "Phase d'authentification".

POSThttps://api.lyra.com/api-payment/V4/Transaction/Refund

Le Web Service REST Transaction/Refund permet de rembourser une transaction (total ou partiel si l'acquéreur le supporte).

  • Statut requis :
    • CAPTURED (Présenté)

Le remboursement se réalise en 2 étapes successives.

  1. Le remboursement est en cours de traitement.
    La transaction a un statut PENDING.
  2. Le remboursement est validé.
    La transaction a un statut AUTHORISED.
  • Pour être notifié du changement de statut (de PENDING vers AUTHORISED), créez une règle personnalisée dans le "Back Office Expert" : Créer une notification de type Remboursement.

Vous pouvez connaître le statut d'une transaction grâce au Web Service Transaction/Get (paramètredetailedStatus).

  • Remboursement partiel :

    • Utilisez le Web Service Transaction/Refund et transmettez un montant inférieur au montant de la transaction.
    • Vous pouvez rembourser partiellement plusieurs fois une transaction, jusqu'à son remboursement total.

  • Remboursement total :

    • Utilisez le Web Service Transaction/Refund et transmettez un montant égal au montant de la transaction.

Paramètres d'entrée

uuid

Référence unique de la transaction générée par la plateforme de paiement.

Format

amount

Montant du paiement dans sa plus petite unité monétaire (le centime pour l'euro).

Exemple: 30050 pour 300,50 EUR.

Format

currency

Devise du paiement. Code alphabétique en majuscule selon la norme ISO 4217 alpha-3.

Exemple: "EUR" pour l'euro.

Format

Valeurs possibles

Les valeurs possibles sont les suivantes:

Devise CODIFICATION ISO 4217 Unité fractionnaire
Dollar australien (036) AUD 2
Dollar canadien (124) CAD 2
Franc suisse (756) CHF 2
Couronne danoise (208) DKK 2
Euro (978) EUR 2
Livre Sterling (826) GBP 2
Yen (392) JPY 0
Couronne norvégienne (578) NOK 2
Couronne suédoise (752) SEK 2
Dollar des États-Unis (840) USD 2

comment

Commentaire libre.

Format

manualValidation

Chemin: transactionOptions.cardOptions.manualValidation

Mode de validation de la transaction.

Format

Valeurs possibles

Les valeurs possibles sont les suivantes:

Valeur Description
NO Validation automatique par la plateforme de paiement.
YES Validation manuelle par le marchand.
null Configuration par défaut de la boutique retenue (paramétrable dans le Back Office Marchand).

captureDelay

Chemin: transactionOptions.cardOptions.captureDelay

Délai à appliquer à la date de capture.

Description

Indique le délai en nombre de jours avant remise en banque.

Si ce paramètre n’est pas transmis, alors la valeur par défaut définie dans le Back Office Expert sera utilisée.

Cette dernière est paramétrable dans le Back Office Expert par toutes les personnes dûment habilitées.

Si le délai avant remise est supérieur à 365 jours dans la requête de paiement, il est automatiquement repositionné à 365 jours.

Format

mid

Numéro de contrat e-commerce commerçant sur lequel faire le remboursement d'une transaction de proximité. Si ce champ est renseigné, veillez à utiliser le bon contrat VADS en fonction du réseau de la carte.

Format

Référence de la réponse

Le web service retourne l'objet suivant:

Réponse Contexte
Transaction Objet contenant les informations de la transaction.

Voir la référence de la réponse pour plus de détails.