Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Dépendance JitPack (voir le README) :
<dependency>
<groupId>com.github.Technas-Organization</groupId>
<artifactId>technas-pay-java</artifactId>
<version>v0.4.0</version>
<version>v0.4.1</version>
</dependency>
```

Expand Down
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,15 +24,15 @@ Maven :
<dependency>
<groupId>com.github.Technas-Organization</groupId>
<artifactId>technas-pay-java</artifactId>
<version>v0.4.0</version>
<version>v0.4.1</version>
</dependency>
```

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 :
Expand Down
116 changes: 115 additions & 1 deletion contract/app-contract.v1.json
Original file line number Diff line number Diff line change
@@ -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",
Expand Down Expand Up @@ -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": {
Expand Down
2 changes: 1 addition & 1 deletion examples/kotlin-spring/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
<dependency>
<groupId>fr.technas</groupId>
<artifactId>technas-pay</artifactId>
<version>0.4.0</version>
<version>0.4.1</version>
</dependency>
</dependencies>
<build>
Expand Down
2 changes: 1 addition & 1 deletion examples/spring-boot/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
<dependency>
<groupId>fr.technas</groupId>
<artifactId>technas-pay</artifactId>
<version>0.4.0</version>
<version>0.4.1</version>
</dependency>
</dependencies>
</project>
2 changes: 1 addition & 1 deletion llms.txt
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
2 changes: 1 addition & 1 deletion pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<modelVersion>4.0.0</modelVersion>
<groupId>fr.technas</groupId>
<artifactId>technas-pay</artifactId>
<version>0.4.0</version>
<version>0.4.1</version>
<name>Technas Pay</name>
<description>Encaisser du mobile money et des paiements par carte via Technas Pay depuis Java ou Kotlin (Spring Boot, Jakarta Servlet).</description>
<url>https://github.com/Technas-Organization/technas-pay-java</url>
Expand Down
2 changes: 1 addition & 1 deletion src/main/java/fr/technas/pay/TechnasPay.java
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@
* }</pre>
*/
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 « . »
Expand Down
10 changes: 9 additions & 1 deletion src/main/java/fr/technas/pay/app/AppRoutes.java
Original file line number Diff line number Diff line change
Expand Up @@ -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;
}
}
}
}

Expand Down
2 changes: 1 addition & 1 deletion src/test/java/fr/technas/pay/AppContractTest.java
Original file line number Diff line number Diff line change
Expand Up @@ -116,7 +116,7 @@ Stream<DynamicTest> 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();
}

Expand Down
Loading