diff --git a/AGENTS.md b/AGENTS.md
index 35bead9..f0764d2 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -20,7 +20,7 @@ Dépendance JitPack (voir le README) :
com.github.Technas-Organization
technas-pay-java
- v0.4.0
+ v0.4.1
```
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0820d44..487bf86 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
# Journal
+## 0.4.1 (16/11/2026)
+
+Routes toutes faites : si l'annulation de l'ancien essai répond 404 (serveur sans la route d'annulation), l'essai suivant est créé comme avant. Contrat v1 à 31 cas.
+
## 0.4.0 (16/11/2026)
`cancelPayment(id)` (`POST /v1/payments/{id}/cancel`) : annule un paiement que personne n'a commencé à payer. `Payment` : `canceledAt()`, `cancelReason()`, `reason()` (avis `payment.expired` : `canceled` ou `timeout`). Routes toutes faites : `POST /payments/{id}/cancel`, et sur `reference_conflict` l'ancien essai est relu puis annulé avant le suivant (aucun second paiement si l'annulation répond `payment_in_progress` ou `payment_already_completed`). Contrat v1 à 30 cas.
diff --git a/README.md b/README.md
index 0fde135..0090b02 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ Maven :
com.github.Technas-Organization
technas-pay-java
- v0.4.0
+ v0.4.1
```
@@ -32,7 +32,7 @@ Gradle (Kotlin) :
```kotlin
repositories { maven("https://jitpack.io") }
-dependencies { implementation("com.github.Technas-Organization:technas-pay-java:v0.4.0") }
+dependencies { implementation("com.github.Technas-Organization:technas-pay-java:v0.4.1") }
```
Technas vous remet **un secret**. Mettez-le dans les variables d'environnement du serveur :
diff --git a/contract/app-contract.v1.json b/contract/app-contract.v1.json
index 4c9f883..0d3f97a 100644
--- a/contract/app-contract.v1.json
+++ b/contract/app-contract.v1.json
@@ -1,7 +1,7 @@
{
"name": "technas-pay-app",
"version": 1,
- "doc": "Contrat entre une app (technas_pay_flutter, TechnasPayClient) et les routes toutes faites des SDK serveur Technas Pay. Les chemins sont relatifs au préfixe de montage (ex. /api/technas-pay). Fichier copié À L'IDENTIQUE dans technas-pay-node, technas-pay-python et technas-pay-dart : chaque dépôt rejoue tous les cas. 'message' est un texte libre, jamais comparé. 'user' : l'utilisateur rendu par authorize (null = non authentifié). 'orders' : ce que resolveOrder rend pour (orderId, user) ; absent = commande inconnue ou d'un autre. 'gateway' : réponses successives de pay-api.technas.fr. Le webhook (POST /webhook, signé) est testé à part : sa signature dépend de l'heure. 'options' : options des routes pour ce cas ({card: true} ouvre la carte). 'admin' : présent = authorizeAdmin est branché et rend cette valeur (null = pas le marchand, 403). Une référence de paiement par carte est orderId-card-N, mobile money orderId-N. Un essai expiré (payment_expired) est sauté. Un essai dont le montant ne correspond plus (reference_conflict : le client a changé d'offre) est relu par sa référence (GET /v1/payments?reference=), annulé s'il est encore ouvert (POST /v1/payments/{id}/cancel), puis l'essai suivant est créé ; si l'annulation répond payment_in_progress ou payment_already_completed, aucun second paiement n'est créé et l'erreur est rendue à l'app. 'query_includes' : paramètres attendus dans l'adresse. Le paiement rendu à l'app porte 'method'.",
+ "doc": "Contrat entre une app (technas_pay_flutter, TechnasPayClient) et les routes toutes faites des SDK serveur Technas Pay. Les chemins sont relatifs au préfixe de montage (ex. /api/technas-pay). Fichier copié À L'IDENTIQUE dans technas-pay-node, technas-pay-python et technas-pay-dart : chaque dépôt rejoue tous les cas. 'message' est un texte libre, jamais comparé. 'user' : l'utilisateur rendu par authorize (null = non authentifié). 'orders' : ce que resolveOrder rend pour (orderId, user) ; absent = commande inconnue ou d'un autre. 'gateway' : réponses successives de pay-api.technas.fr. Le webhook (POST /webhook, signé) est testé à part : sa signature dépend de l'heure. 'options' : options des routes pour ce cas ({card: true} ouvre la carte). 'admin' : présent = authorizeAdmin est branché et rend cette valeur (null = pas le marchand, 403). Une référence de paiement par carte est orderId-card-N, mobile money orderId-N. Un essai expiré (payment_expired) est sauté. Un essai dont le montant ne correspond plus (reference_conflict : le client a changé d'offre) est relu par sa référence (GET /v1/payments?reference=), annulé s'il est encore ouvert (POST /v1/payments/{id}/cancel), puis l'essai suivant est créé ; si l'annulation répond payment_in_progress ou payment_already_completed, aucun second paiement n'est créé et l'erreur est rendue à l'app ; si elle répond 404 (paiement introuvable, ou route d'annulation absente d'un serveur plus ancien), l'essai suivant est créé comme avant. 'query_includes' : paramètres attendus dans l'adresse. Le paiement rendu à l'app porte 'method'.",
"routes": [
{
"method": "GET",
@@ -332,6 +332,120 @@
}
}
},
+ {
+ "name": "démarrer : changement d'offre, l'annulation n'existe pas encore sur ce serveur (404) → essai suivant, comme avant",
+ "request": {
+ "method": "POST",
+ "path": "/payments",
+ "body": {
+ "orderId": "42"
+ }
+ },
+ "user": "u1",
+ "orders": {
+ "42": {
+ "amount": 7500,
+ "customer": {
+ "email": "awa@exemple.tg",
+ "name": "Awa Mensah"
+ }
+ }
+ },
+ "gateway": [
+ {
+ "status": 409,
+ "body": {
+ "code": "reference_conflict",
+ "message": "m"
+ }
+ },
+ {
+ "status": 200,
+ "body": {
+ "id": "pay_1",
+ "reference": "42-1",
+ "amount": 5000,
+ "currency": null,
+ "commission": 100,
+ "net_amount": 4900,
+ "status": "pending",
+ "checkout_url": "https://pay-api.technas.fr/checkout/pay_1",
+ "metadata": {},
+ "test_mode": true,
+ "created_at": "2026-11-15T10:00:00Z",
+ "expires_at": "2026-11-15T11:00:00Z"
+ }
+ },
+ {
+ "status": 404,
+ "body": {
+ "code": "not_found",
+ "message": "Not Found"
+ }
+ },
+ {
+ "status": 201,
+ "body": {
+ "id": "pay_2",
+ "reference": "42-2",
+ "amount": 7500,
+ "currency": null,
+ "commission": 150,
+ "net_amount": 7350,
+ "status": "pending",
+ "checkout_url": "https://pay-api.technas.fr/checkout/pay_2",
+ "metadata": {},
+ "test_mode": true,
+ "created_at": "2026-11-15T10:00:00Z",
+ "expires_at": "2026-11-15T11:00:00Z"
+ }
+ }
+ ],
+ "expect_gateway": [
+ {
+ "method": "POST",
+ "path": "/v1/payments",
+ "body_includes": {
+ "amount": 7500,
+ "reference": "42-1"
+ }
+ },
+ {
+ "method": "GET",
+ "path": "/v1/payments",
+ "query_includes": {
+ "reference": "42-1"
+ }
+ },
+ {
+ "method": "POST",
+ "path": "/v1/payments/pay_1/cancel"
+ },
+ {
+ "method": "POST",
+ "path": "/v1/payments",
+ "body_includes": {
+ "amount": 7500,
+ "reference": "42-2"
+ }
+ }
+ ],
+ "expect": {
+ "status": 200,
+ "body": {
+ "payment": {
+ "id": "pay_2",
+ "reference": "42-2",
+ "status": "pending",
+ "checkout_url": "https://pay-api.technas.fr/checkout/pay_2",
+ "amount": 7500,
+ "currency": null,
+ "expires_at": "2026-11-15T11:00:00Z",
+ "method": "mobile_money"
+ }
+ }
+ }
+ },
{
"name": "démarrer : changement d'offre, l'ancien essai avait déjà expiré → pas d'annulation, essai suivant",
"request": {
diff --git a/examples/kotlin-spring/pom.xml b/examples/kotlin-spring/pom.xml
index b0ea31b..3526f40 100644
--- a/examples/kotlin-spring/pom.xml
+++ b/examples/kotlin-spring/pom.xml
@@ -28,7 +28,7 @@
fr.technas
technas-pay
- 0.4.0
+ 0.4.1
diff --git a/examples/spring-boot/pom.xml b/examples/spring-boot/pom.xml
index fc2b826..4a4ae91 100644
--- a/examples/spring-boot/pom.xml
+++ b/examples/spring-boot/pom.xml
@@ -23,7 +23,7 @@
fr.technas
technas-pay
- 0.4.0
+ 0.4.1
diff --git a/llms.txt b/llms.txt
index 349f94f..d7493f8 100644
--- a/llms.txt
+++ b/llms.txt
@@ -1,6 +1,6 @@
# technas-pay-java (Java, Kotlin)
-> SDK Java 17+ et Kotlin (côté serveur : Spring Boot, Quarkus, Micronaut, Ktor) pour encaisser du mobile money en Afrique et des paiements par carte via Technas Pay, rembourser et recharger son solde. Une dépendance (jackson-databind). Montant seul, en F CFA : la devise (XOF ou XAF) suit le pays du client. Installation depuis GitHub par JitPack : com.github.Technas-Organization:technas-pay-java:v0.4.0.
+> SDK Java 17+ et Kotlin (côté serveur : Spring Boot, Quarkus, Micronaut, Ktor) pour encaisser du mobile money en Afrique et des paiements par carte via Technas Pay, rembourser et recharger son solde. Une dépendance (jackson-databind). Montant seul, en F CFA : la devise (XOF ou XAF) suit le pays du client. Installation depuis GitHub par JitPack : com.github.Technas-Organization:technas-pay-java:v0.4.1.
Agents de code : lisez d'abord AGENTS.md.
diff --git a/pom.xml b/pom.xml
index a4dcbd7..0c0d6c9 100644
--- a/pom.xml
+++ b/pom.xml
@@ -4,7 +4,7 @@
4.0.0
fr.technas
technas-pay
- 0.4.0
+ 0.4.1
Technas Pay
Encaisser du mobile money et des paiements par carte via Technas Pay depuis Java ou Kotlin (Spring Boot, Jakarta Servlet).
https://github.com/Technas-Organization/technas-pay-java
diff --git a/src/main/java/fr/technas/pay/TechnasPay.java b/src/main/java/fr/technas/pay/TechnasPay.java
index e1ce91d..a8158ba 100644
--- a/src/main/java/fr/technas/pay/TechnasPay.java
+++ b/src/main/java/fr/technas/pay/TechnasPay.java
@@ -50,7 +50,7 @@
* }
*/
public final class TechnasPay {
- public static final String VERSION = "0.4.0";
+ public static final String VERSION = "0.4.1";
public static final String DEFAULT_BASE_URL = "https://pay-api.technas.fr";
public static final String SECRET_ENV = "TECHNAS_PAY_SECRET";
private static final Pattern SECRET = Pattern.compile("^tps_(live|test)_([\\x21-\\x2d\\x2f-\\x7e]+)\\.([\\x21-\\x2d\\x2f-\\x7e]+)$"); // ASCII imprimable sans « . »
diff --git a/src/main/java/fr/technas/pay/app/AppRoutes.java b/src/main/java/fr/technas/pay/app/AppRoutes.java
index 28e7fb8..2c3e286 100644
--- a/src/main/java/fr/technas/pay/app/AppRoutes.java
+++ b/src/main/java/fr/technas/pay/app/AppRoutes.java
@@ -169,7 +169,15 @@ private void closePrevious(String reference) {
throw new TechnasPayException("payment_already_completed", "L'essai précédent de cette commande est déjà payé", 409, Map.of());
}
if (!"expired".equals(previous.status())) {
- pay.cancelPayment(previous.id());
+ try {
+ pay.cancelPayment(previous.id());
+ } catch (TechnasPayException e) {
+ // 404 : paiement disparu, ou serveur plus ancien sans route d'annulation : on continue
+ // comme avant (essai suivant). Tout autre refus remonte : aucun second paiement.
+ if (e.status() != 404) {
+ throw e;
+ }
+ }
}
}
diff --git a/src/test/java/fr/technas/pay/AppContractTest.java b/src/test/java/fr/technas/pay/AppContractTest.java
index 5aca13d..7c0ef51 100644
--- a/src/test/java/fr/technas/pay/AppContractTest.java
+++ b/src/test/java/fr/technas/pay/AppContractTest.java
@@ -116,7 +116,7 @@ Stream contrat() throws IOException {
}
}));
}
- assertEquals(30, tests.size(), "le contrat v1 a 30 cas");
+ assertEquals(31, tests.size(), "le contrat v1 a 31 cas");
return tests.stream();
}