Réponse Subscription
Objet contenant les informations relatives à un abonnement.
Référence de la réponse
subscriptionId
Identifiant de l'abonnement.
Format
shopId
Identifiant de la boutique.
Format
paymentMethodToken
Alias (ou token) associé à un moyen 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
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
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
cancelDate
Date de résiliation de l'abonnement.
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
amount
Montant des échéances de l’abonnement, hormis celles éventuellement définies par initilAmount.
La valeur doit être exprimée dans la plus petite unité de la devise.
Format
currency
Devise utilisée pour le paiement des échéances d'un abonnement. Code alphabétique en majuscule selon la norme ISO 4217 alpha-3.
Exemple: "EUR" pour l'euro.
Valeurs possibles
Les valeurs possibles sont les suivantes:
| Devise | CODIFICATION ISO 4217 | Unité fractionnaire |
|---|---|---|
| Dollar australien (036) | AUD | |
| Riel Cambodgien (116) | KHR | 0 |
| Dollar canadien (124) | CAD | 2 |
| Renminbi yuan chinois (156) | CNY | 1 |
| Couronne tchèque (203) | CZK | 2 |
| Couronne danoise (208) | DKK | 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 |
| Won Sud Coréen (410) | KRW | 0 |
| Dinar Koweïtien (414) | KWD | 3 |
| Ringgit malais (458) | MYR | 2 |
| Peso mexicain (484) | MXN | 2 |
| Dirham Marocain (504) | MAD | 2 |
| Dollar néo-zélandais (554) | NZD | 2 |
| Couronne norvégienne (578) | NOK | 2 |
| Peso philippin (608) | PHP | 2 |
| Rouble russe (643) | RUB | 2 |
| Dollar de Singapour (702) | SGD | 2 |
| Rand sud-africain (710) | ZAR | 2 |
| Couronne suédoise (752) | SEK | 2 |
| Franc suisse (756) | CHF | 2 |
| Baht thailandais (764) | THB | 2 |
| Dinar Tunisien (788) | TND | 3 |
| Livre Sterling (826) | GBP | 2 |
| Dollar des États-Unis (840) | USD | 2 |
| Nouveau dollar de Taïwan (901) | TWD | 2 |
| Lire turque (949) | TRY | 2 |
| Euro (978) | EUR | 2 |
| Zloty polonais (985) | PLN | 2 |
| Real du Brésil (986) | BRL | 2 |
Format
pastPaymentsNumber
Nombre de versements échus.
Format
totalPaymentsNumber
Nombre total de paiements.
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
description
Description associée à l'abonnement.