Versions et changements

Comment l'API évolue

Nous ne cassons pas une intégration qui fonctionne. Concrètement :

• Un champ peut apparaître dans une réponse à tout moment. Votre code doit ignorer ce qu'il ne connaît pas — c'est la seule chose que nous vous demandons.
• Une valeur peut s'ajouter à une énumération : un nouveau status, un nouveau failure_code, un nouveau type d'événement. Prévoyez une branche par défaut.
• Un champ existant ne change jamais de sens ni de type.
• Une route ne disparaît jamais sans annonce préalable.

Tout changement qui romprait ces règles serait servi sous une nouvelle version d'API, et l'ancienne continuerait de répondre.

La version

Elle est datée : 2026-08-25. Vous la retrouvez dans chaque événement de webhook, champ api_version — utile quand un événement dort en file pendant une montée de version.

Journal

2026-08-26

• Site de documentation public : vous y êtes.
• Alerte marchand quand un endpoint de webhook est désactivé, visible sur tous les écrans de la console.
• Rejeu en masse des livraisons en échec, depuis l'onglet Webhooks.
• Numéros de test documentés : dix scénarios, y compris les issues incertaines.

2026-08-25

• Spécification OpenAPI publiée, SDK JavaScript / TypeScript.
• Journal des requêtes API dans la console : route, code, latence, code d'erreur exact, identifiant de requête.
• L'en-tête de traçabilité s'appelle désormais Valsoria-Request-Id.

2026-08-21

• Webhooks : signature HMAC, horodatage anti-rejeu, tentatives espacées, journal des livraisons et rejeu manuel.
• Remboursements total et partiel.
• Checkout hébergé : lien de paiement pour encaisser sans intégration.

2026-08-20

• Première version : encaissement, clés API par environnement, ledger en partie double, idempotence.

Version d'API 2026-08-25 · changements · spécification OpenAPI