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(); }