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.systempay.fr/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é)

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
Lev Bulgare (975) BGN 2
Real du Brésil (986) BRL 2
Dollar canadien (124) CAD 2
Franc suisse (756) CHF 2
Renminbi yuan chinois (156) CNY 1
Couronne tchèque (203) CZK 2
Couronne danoise (208) DKK 2
Euro (978) EUR 2
Livre Sterling (826) GBP 2
Dollar de Hong Kong (344) HKD 2
Kuna Croate (191) HRK 2
Forint hongrois (348) HUF 2
Roupie Indienne (356) INR 2
Roupie indonésienne (360) IDR 2
Yen (392) JPY 0
Riel Cambodgien (116) KHR 0
Won Sud Coréen (410) KRW 0
Peso mexicain (484) MXN 2
Ringgit malais (458) MYR 2
Dollar néo-zélandais (554) NZD 2
Couronne norvégienne (578) NOK 2
Peso philippin (608) PHP 2
Zloty polonais (985) PLN 2
Leu Roumain (946) RON 2
Rouble russe (643) RUB 2
Dollar de Singapour (702) SGD 2
Couronne suédoise (752) SEK 2
Baht thailandais (764) THB 2
Lire turque (949) TRY 2
Nouveau dollar de Taïwan (901) TWD 2
Dollar des États-Unis (840) USD 2
Franc CFP (953) XPF 0
Rand sud-africain (710) ZAR 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 Marchand sera utilisée.

Cette dernière est paramétrable dans le Back Office Marchand 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 commerçant. Ce champ ne peut pas être utilisé et doit être null.

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.