Web service 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 .
Exemple: 30050 pour 30050 XPF.
Format
currency
Devise du paiement. Code alphabétique en majuscule selon la norme ISO 4217 alpha-3.
Exemple: "XPF" pour le franc CFP.
Format
Valeurs possibles
Les valeurs possibles sont les suivantes:
Devise | CODIFICATION ISO 4217 | Unité fractionnaire |
---|---|---|
Franc CFP (953) | XPF | 0 |
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
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
Cette dernière est paramétrable dans le
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.
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 |
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.