Politique de dépréciation

Ce que Tupay garantit dans le temps, pour que vous puissiez vous engager sur une intégration.

Nos engagements

Support d’une version: 24 mois
Préavis: 6 mois
Canal d’annonce: email

Comment une version fonctionne

Chaque clé API porte une version, figée à sa création. Une intégration existante ne change jamais de forme, même quand l’API évolue. Versions publiées à ce jour : 2026-01-01.

Pour adopter une nouvelle version, créez une nouvelle clé, ou envoyez l’en-tête Tupay-Version. Une version inconnue est refusée en 400 unsupported_version, jamais ignorée en silence.

Ce qui est déprécié aujourd’hui

Tout ce qui suit est toujours servi, avec la même valeur qu’avant. Rien n’a été retiré. Lisez la colonne « à lire à la place » pour préparer la suite.

Déprécié	Où	À lire à la place	Retrait
`hasMore` annoncé le 2026-08-19	les six collections paginées	has_more	date à venir, préavis de 6 mois garanti
`offset` annoncé le 2026-08-19	cinq collections paginées	starting_after et ending_before	date à venir, préavis de 6 mois garanti
`createdAt` annoncé le 2026-08-21	les huit ressources	created, en secondes Unix	date à venir, préavis de 6 mois garanti
`kyb_status, iban_xpf, tgc_rate, created_at, updated_at` annoncé le 2026-08-21	GET et PATCH /merchants/me	kybStatus, ibanXpf, tgcRate, createdAt, updatedAt	date à venir, préavis de 6 mois garanti
`intentId et transactionId` annoncé le 2026-08-21	POST /payments/intent	id, et le code du prestataire n’est plus au contrat	date à venir, préavis de 6 mois garanti
`les champs de transaction servis à plat` annoncé le 2026-08-21	POST /test/simulate	la clé transaction	date à venir, préavis de 6 mois garanti
`apres` annoncé le 2026-08-19	GET /events	starting_after	date à venir, préavis de 6 mois garanti

Comment vous serez prévenu

Un appel qui emploie un paramètre déprécié reçoit les en-têtes Deprecation et, dès qu’une date est fixée, Sunset. Ces en-têtes ne changent ni le statut, ni le corps : l’appel réussit exactement comme avant.

Nous ne pouvons pas détecter l’usage des champs de réponse dépréciés : ils sont servis à tout le monde, et rien ne dit qui les lit. Pour ceux-là, le préavis de 6 mois par email est votre garantie, et nous les retirerons ensemble, en une seule version datée, plutôt qu’un par un.