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