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)
Pour plus de détails sur les statuts, consultez l'article suivant : Cycle de vie d'une transaction.
Paramètres de la requête
uuid
Référence unique de la transaction générée par la plateforme de paiement.
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 |
|---|---|---|
| Peso argentino (032) | ARS | 2 |
| 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 |
| Peso Colombiano (170) | COP | 2 |
| 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 |
| Sol peruano (604) | PEN | 2 |
| Peso philippin (608) | PHP | 2 |
| Zloty polonais (985) | PLN | 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 |
| Franc CFA (952) | XOF | 0 |
| 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 |
|---|---|
| Common/ResponseCodeAnswer | Objet contenant le code de retour du web service. |
Voir la référence de la réponse pour plus de détails.