Web service Subscription/Update
Le Web Service REST Subscription/Update permet de modifier un abonnement, à savoir :
- les échéances de paiement : un montant, une devise, une date d’échéance, un statut, etc.
- ou encore les données relatives à l'acheteur.
Cette opération ne peut pas être appelée si la date d'effet est atteinte.
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.
Format
Valeurs possibles
Les valeurs possibles sont les suivantes:
| 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 |
description
Description associée à l'abonnement.
Format
effectDate
Date de début de l’abonnement au format ISO 8601.
Il est recommandé de transmettre une valeur dans le fuseau UTC. L'heure doit être fixée à "00:00:00".
Exemple : 2025-01-14T00:00:00+00:00
La valeur de effectDate ne doit pas être dans le passé.
Format
initialAmount
Montant des premières échéances. Sa valeur doit être un entier positif (ex: 1234 pour 12.34 EUR).
Format
initialAmountNumber
Nombre d'échéances auxquelles appliquer le montant défini dans initalAmount.
Format
paymentMethodToken
Alias (ou token) associé à un moyen de paiement.
Format
rrule
Description de la règle de l'abonnement sous forme de rrule (RFC-5545).
Pour plus d'informations sur comment générer une RRULE:
Pour des raisons techniques, il est impossible de définir des périodes d’abonnement inférieures à une journée.
Les mots clés "SECONDLY" / "MINUTELY" / "HOURLY" ne sont donc pas pris en compte.
Format
subscriptionId
Identifiant de l'abonnement.
Format
paymentSource
Chemin: transactionOptions.cardOptions.paymentSource
Origine du paiement.
Format
Valeurs possibles
Les valeurs possibles sont les suivantes:
| Valeur | Description |
|---|---|
| EC | E-Commerce: les données du moyen de paiement sont saisies par l'acheteur. Cette valeur permet d'avoir une authentification forte lors du paiement. |
| MOTO | MAIL OR TELEPHONE ORDER: Saisie réalisée par un opérateur. Les informations du moyen de paiement sont transmises par courrier ou par e-mail. Nécessite un contrat de type VAD. |
| CC | Call Center: paiement effectué via un centre d’appel. Nécessite un contrat de type VAD. |
| OTHER | Autre canal de vente. Valeur de sortie retournée pour les paiements réalisés depuis le |
| Absent ou null | La valeur par défaut est "EC". |
mid
Chemin: transactionOptions.cardOptions.mid
Numéro de contrat commerçant. Si ce champ est renseigné, veillez à utiliser le bon contrat en fonction du réseau de la carte.
Un contrat CB ne peut être utilisé pour une transaction AMEX.
Format
manualValidation
Chemin: transactionOptions.cardOptions.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 |
captureDelay
Chemin: transactionOptions.cardOptions.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
firstInstallmentDelay
Chemin: transactionOptions.cardOptions.firstInstallmentDelay
Nombre de mois de différé à appliquer sur la première échéance d'un paiement en plusieurs fois. Champ spécifique aux acquéreurs d’Amérique Latine.
Format
installmentNumber
Chemin: transactionOptions.cardOptions.installmentNumber
Nombre d'échéances.
Format
retry
Chemin: transactionOptions.cardOptions.retry
Nombre de nouvelles tentatives disponibles en cas de refus de paiement (3 par défaut).
Format
debitCreditSelector
Chemin: transactionOptions.cardOptions.debitCreditSelector
Ce champ est spécifique au Brésil pour la gestion des cartes multiplo.
Les cartes "multiplo" sont des cartes de paiement (Elo, Visa ou Mastercard), permettant de régler :
- soit en débit immédiat : le montant est débité tout de suite, et le marchand est crédité à J+1.
- soit en crédit : le débit est différé et le montant peut être débité en une ou plusieurs échéances. Le marchand est crédité plus tard de la totalité ou seulement d'une partie du montant total.
Ce champ permet de forcer l'utilisation de la carte en débit ou en crédit.
Valeurs possibles
| valeurs | Description |
|---|---|
| DEBIT | Utilisation de la fonction "débit" de la carte |
| CREDIT | Utilisation de la fonction "crédit" de la carte |
Format
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.