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-09-07

Les en-têtes prennent le nom LibrePay — et les anciens continuent d'arriver.

La plateforme s'appelle LibrePay depuis le 2026-09-03 ; les en-têtes portaient encore l'ancienne marque. Nous envoyons désormais les deux, avec la même valeur :

Rien ne casse. Lisez le nouveau nom avec l'ancien en repli (req.header('LibrePay-Signature') ?? req.header('Valsoria-Signature')), et vous serez prêts le jour où les anciens partiront — ce qui n'arrivera pas sans une annonce préalable ici.

Le SDK suit : le paquet devient @librepay/pay et la classe LibrePay. ValsoriaPay et ValsoriaPayError restent exportés comme alias.

Ce qui a été corrigé dans cette documentation le même jour, parce qu'elle affirmait des choses fausses :

• le carnet de bénéficiaires s'écrit et se lit par API, et la liste pagine — la page Décaissements disait le contraire ;
• décaissements, lots, bénéficiaires et règlements existent dans l'API ; la page SDK les annonçait absents. Le SDK couvre les deux premiers ;
• 21 codes d'erreur que l'API renvoie n'étaient documentés nulle part. Ils le sont, et un contrôle automatique refuse désormais qu'un code parte sans être décrit.

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 alors Valsoria-Request-Id (renommé LibrePay-Request-Id le 2026-09-07 ; les deux sont envoyés).

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