support
Retour à la documentation
Rechercher
Catégories
Tags
Paramètres principauxtout montrer
amount
requis
currency
requis
uuid
requis
orderId
recommandé
options générales
comment
metadata
[1]
:
options relatives à la méthode de paiement
cardDuplicate
manualValidation
captureDelay
nouveaux paramètres
acquirerTransientData
[1]
:
Testez moi
Documentation

Web service Transaction/Duplicate

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

POSThttps://api-sogecommerce.societegenerale.eu/api-payment/V4/Transaction/Duplicate

Le Web Service REST Transaction/Duplicate permet de créer une nouvelle transaction à partir d'une transaction existante en conservant les mêmes caractéristiques (exemple : moyen de paiement, informations de l’acheteur).

Les transactions pouvant faire l’objet d’une duplication doivent posséder un des detailedStatus suivants:

  • CAPTURED (Remisé)
  • EXPIRED (Expiré)
  • CANCELLED (Annulé)
  • REFUSED (Refusé)

La duplication de transactions refusées, réalisées avec des cartes Mastercard (Mastercard, Maestro, Mastercard Debit), est interdite lorsque le motif du refus est compris dans la liste ci-dessous:

  • 04 - Capture card
  • 41 - Lost card
  • 14 - Invalid card number
  • 43 - Stolen card
  • 15 - Invalid issuer
  • 54 - Expired card

Plus d'infos sur les statuts, consultez : Cycle de vie d'une transaction.

Consultez les paramètres de la réponse Transaction.

Paramètres d'entrée

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.

Valeurs possibles

Devise CODIFICATION ISO 4217 Unité fractionnaire
Dollar australien (036) AUD 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
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
Dinar Koweïtien (414) KWD 3
Dirham Marocain (504) MAD 2
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
Dinar Tunisien (788) TND 3
Lire turque (949) TRY 2
Nouveau dollar de Taïwan (901) TWD 2
Dollar des États-Unis (840) USD 2
Rand sud-africain (710) ZAR 2

Format

uuid

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

Format

orderId

Référence de la commande définie par le marchand. Ne prend pas en charge les caractères UTF-8.

Format

comment

Commentaire libre.

Format

metadata

Valeurs personnalisées rattachées à la transaction, au format JSON.

Exemple d'appel

Par exemple, pour passer une valeur personnalisée, ajoutez à votre requête :

{
    "metadata": {
        "MyValueKey": "1234"
    }
}

Cette valeur sera retournée dans l'objet Transaction nouvellement créé.

Vous pouvez aussi utiliser les metadatas "orderInfo", "orderInfo2" et "orderInfo3" pour transmettre des informations additionnelles sur la commande.

Ces données seront ensuite visibles dans l'onglet **Extra** du détail de la transaction depuis votre Back Office Marchand.

Format

captureDelay

Chemin: cardDuplicate.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

manualValidation

Chemin: cardDuplicate.manualValidation

Mode de validation de la transaction.

Valeurs possibles

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

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.