Web service Transaction/Update
Le Web Service REST Transaction/Update permet de modifier certaines caractéristiques d'une transaction existante :
- Modifier le montant d’une transaction (à la baisse),
- Modifier la date de remise souhaitée,
- Modifier le mode de validation (possibilité de passer de la validation manuelle à la validation automatique mais pas l’inverse).
Les transactions pouvant faire l’objet d’une modification possèdent l’un des detailedStatus suivants :
- AUTHORISED_TO_VALIDATE (A valider)
- WAITING_AUTHORISATION_TO_VALIDATE (A valider et autoriser)
- WAITING_AUTHORISATION (En attente d’autorisation)
- AUTHORISED (En attente de remise)
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
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
orderId
Référence de la commande définie par le marchand. Ne prend pas en charge les caractères UTF-8.
Format
cardUpdate.amount
Montant du paiement dans sa plus petite unité monétaire (le centime pour l'euro).
Exemple: 30050 pour 300,50 EUR.
Format
cardUpdate.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 |
expectedCaptureDate
Chemin: cardUpdate.expectedCaptureDate
Date de remise en banque exprimée au format ISO 8601 définit par W3C.
Format
manualValidation
Chemin: cardUpdate.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.