diff --git a/examples/spring-boot/pom.xml b/examples/spring-boot/pom.xml
index 25e0ea8..a682f66 100644
--- a/examples/spring-boot/pom.xml
+++ b/examples/spring-boot/pom.xml
@@ -23,7 +23,7 @@
fr.technas
technas-pay
- 0.2.0
+ 0.2.1
diff --git a/llms.txt b/llms.txt
index 4e5f4b7..e61595e 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.2.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.2.1.
Agents de code : lisez d'abord AGENTS.md.
diff --git a/pom.xml b/pom.xml
index 3f3a279..50c5830 100644
--- a/pom.xml
+++ b/pom.xml
@@ -4,7 +4,7 @@
4.0.0
fr.technas
technas-pay
- 0.2.0
+ 0.2.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 0ee3704..f05d318 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.2.0";
+ public static final String VERSION = "0.2.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/model/KycNotice.java b/src/main/java/fr/technas/pay/model/KycNotice.java
index b2031aa..fdf7e27 100644
--- a/src/main/java/fr/technas/pay/model/KycNotice.java
+++ b/src/main/java/fr/technas/pay/model/KycNotice.java
@@ -8,13 +8,22 @@
* Contenu de l'avis {@code account.kyc_required} : envoyé à 80 % du seuil, 7 jours avant
* l'échéance, puis au premier refus. Prévenez le responsable du compte.
*
- * @param reason {@code amount_80}, {@code deadline_7d} ou {@code blocked}
+ * Les champs {@code stage}, {@code blockReason}, {@code daysElapsed}, {@code graceDays} et
+ * {@code firstCollectedAt} reprennent {@code GET /v1/account/kyc} ; ils sont {@code null} dans un
+ * avis plus ancien.
+ *
+ * @param reason le DÉCLENCHEUR de l'avis : {@code amount_80}, {@code deadline_7d} ou {@code blocked}
+ * @param stage {@code ok}, {@code soon}, {@code blocked}, {@code verified}, {@code not_applicable}
+ * @param blockReason {@code amount}, {@code duration}, ou {@code null}
*/
public record KycNotice(String reason, BigDecimal collectedXof, BigDecimal thresholdXof, String deadline, boolean blocked,
- String consoleUrl) {
+ String consoleUrl, String stage, String blockReason, Integer daysElapsed, Integer graceDays,
+ String firstCollectedAt) {
public static KycNotice fromJson(JsonNode r) {
return new KycNotice(Json.str(r, "reason"), Json.num(r, "collected_xof"), Json.num(r, "threshold_xof"),
- Json.nstr(r, "deadline"), Json.bool(r, "blocked"), Json.nstr(r, "console_url"));
+ Json.nstr(r, "deadline"), Json.bool(r, "blocked"), Json.nstr(r, "console_url"), Json.nstr(r, "stage"),
+ Json.nstr(r, "block_reason"), AccountKyc.integer(r, "days_elapsed"), AccountKyc.integer(r, "grace_days"),
+ Json.nstr(r, "first_collected_at"));
}
}
diff --git a/src/test/java/fr/technas/pay/SeuilKycTest.java b/src/test/java/fr/technas/pay/SeuilKycTest.java
index d49587d..c81370d 100644
--- a/src/test/java/fr/technas/pay/SeuilKycTest.java
+++ b/src/test/java/fr/technas/pay/SeuilKycTest.java
@@ -90,6 +90,28 @@ void avisSigneAppelleOnKycRequired() {
assertEquals("https://c", seen.get(0).consoleUrl());
assertFalse(seen.get(0).blocked());
assertNull(r.event().payment());
+ assertNull(seen.get(0).stage(), "avis ancien : champs complémentaires nuls");
+ assertNull(seen.get(0).daysElapsed());
+ }
+
+ @Test
+ void avisCompletLuEnEntier() {
+ TechnasPay pay = pay(new FakeTransport());
+ List seen = new ArrayList<>();
+ String body = "{\"id\":\"e2\",\"type\":\"account.kyc_required\",\"created_at\":\"x\",\"data\":{\"reason\":\"blocked\","
+ + "\"collected_xof\":1000000,\"threshold_xof\":1000000,\"deadline\":null,\"blocked\":true,\"console_url\":\"https://c\","
+ + "\"stage\":\"blocked\",\"block_reason\":\"amount\",\"days_elapsed\":12,\"grace_days\":30,"
+ + "\"first_collected_at\":\"2026-11-03T10:00:00+00:00\"}}";
+ pay.handleWebhook(body, Signature.sign(body, ClientTest.WEBHOOK_SECRET), WebhookHandlers.builder().onKycRequired(e -> seen.add(e.kyc())).build());
+ KycNotice k = seen.get(0);
+ assertEquals("blocked", k.reason());
+ assertEquals("blocked", k.stage());
+ assertEquals("amount", k.blockReason());
+ assertEquals(12, k.daysElapsed());
+ assertEquals(30, k.graceDays());
+ assertEquals("2026-11-03T10:00:00+00:00", k.firstCollectedAt());
+ assertTrue(k.blocked());
+ assertNull(k.deadline());
}
@Test