La durée maximale d’une transaction est de 60 jours (86 400 minutes) ou 180 jours (259 200 minutes) en fonction de vos droits sur l’espace de travail.
Si vous souhaitez activer les transactions à long terme (180 jours), vous devez contacter votre gestionnaire de compte chez Universign. Une fois les transactions à long terme activées, toutes les nouvelles transactions auront une durée de vie maximale de 180 jours. Cependant, l’activation n’est pas rétroactive : les transactions créées avant l’activation conserveront une durée de vie maximale de 60 jours.
Vous pouvez définir la durée de vie d’une transaction en fixant soit sa durée, soit sa date d’expiration. Par défaut, une transaction expire 14 jours (20 160 minutes) après son lancement.
Si vous définissez une duration, cela ne peut être fait que lorsque la transaction est en status draft. La valeur de la durée est exprimée en minutes et prend effet lorsque la transaction est lancée. Une fois la transaction lancée, la durée est automatiquement convertie en date d’expiration. Si vous souhaitez modifier l’expiration une fois la transaction lancée, vous devez donc passer une date. Soyez prudent lorsque vous mettez à jour la date d’expiration : si vous définissez une date antérieure à la date actuelle, la transaction expirera immédiatement.
La date d’expiration peut être définie lors de la création de la transaction ou une fois qu’elle est lancée, via le paramètre expires_at. Le format de date attendu est ISO 8601 (aaaa-MM-jjTHH:mm:ssZ). Les secondes (ss) sont facultatives, par exemple 2022-11-14T17:32Z. La durée maximale d’une transaction étant de 60 ou 180 jours, vous pouvez définir la date d’expiration à la date actuelle + 67 jours ou 187 jours (les 7 jours supplémentaires correspondent à la période maximale en état de brouillon).
Important : une transaction peut rester en draft pendant 7 jours, mais elle sera automatiquement supprimée après cette période, même si une durée ou une date d’expiration a été configurée.
Définir la durée d’une transaction
Pour définir une durée lors de la création d’une transaction, envoyez une requête à POST /v1/transactions et transmettez l’argument duration en minutes :
curl
https://api.universign.com/v1/transactions \
-d duration=20160
Éditer la durée d’une transaction en cours
Pour éditer la durée d’une transaction en cours, envoyez une requête à POST /v1/transactions/{transaction_id} et transmettez l’argument duration en minutes :
curl
https://api.universign.com/v1/transactions/tx_AWo949MOq0JE \
-d duration=86400
Définir une date d’expiration
Pour définir une date d’expiration lors de la création d’une transaction, envoyez une requête à POST /v1/transactions et transmettez l’argument expires_at au format de date ISO 8601 :
curl
https://api.universign.com/v1/transactions \
-d expires_at=2021-10-14T17:32Z
Éditer la date d’expiration d’une transaction en cours
Pour éditer la date d’expiration d’une transaction en cours, envoyez une requête à POST /v1/transactions/{transaction_id} et transmettez l’argument expires_at au format ISO 8601 :
curl
https://api.universign.com/v1/transactions/tx_AWo949MOq0JE \
-d expires_at=2022-11-14T17:32Z
Important : ne transmettez pas les paramètres expires_at et duration simultanément, sinon l’API renvoie une erreur.
