From ffe6cc03abb8a74afafc37436074aceb5a518904 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jonas=20Vihoal=C3=A9=20ANIGLO?= <46029829+JIV-DLS@users.noreply.github.com> Date: Sun, 15 Nov 2026 20:35:59 +0100 Subject: [PATCH] Avis account.kyc_required complet : stage, blockReason, jours, 0.2.1 --- AGENTS.md | 2 +- CHANGELOG.md | 4 ++++ README.md | 6 ++--- examples/kotlin-spring/pom.xml | 2 +- examples/spring-boot/pom.xml | 2 +- llms.txt | 2 +- pom.xml | 2 +- src/main/java/fr/technas/pay/TechnasPay.java | 2 +- .../java/fr/technas/pay/model/KycNotice.java | 15 ++++++++++--- .../java/fr/technas/pay/SeuilKycTest.java | 22 +++++++++++++++++++ 10 files changed, 47 insertions(+), 12 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 5da79ad..1c5346c 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.2.0 + v0.2.1 ``` diff --git a/CHANGELOG.md b/CHANGELOG.md index 4bb33bd..4953525 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,9 @@ # Journal +## 0.2.1 (15/11/2026) + +Avis `account.kyc_required` complet : `stage()`, `blockReason()`, `daysElapsed()`, `graceDays()`, `firstCollectedAt()` (nuls dans un avis plus ancien). + ## 0.2.0 (15/11/2026) Seuil d'identité : `getAccountKyc()` (`GET /v1/account/kyc`), avis `account.kyc_required` (`onKycRequired`, `event.kyc()`), précisions `consoleUrl` (`kyc_required`) et `version` (`contract_required`) dans `details()`. diff --git a/README.md b/README.md index 2a24651..86078d1 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ Maven : com.github.Technas-Organization technas-pay-java - v0.2.0 + v0.2.1 ``` @@ -32,7 +32,7 @@ Gradle (Kotlin) : ```kotlin repositories { maven("https://jitpack.io") } -dependencies { implementation("com.github.Technas-Organization:technas-pay-java:v0.2.0") } +dependencies { implementation("com.github.Technas-Organization:technas-pay-java:v0.2.1") } ``` Technas vous remet **un secret**. Mettez-le dans les variables d'environnement du serveur : @@ -163,7 +163,7 @@ Codes et conduite à tenir : [AGENTS.md](AGENTS.md#erreurs). ## Seuil d'identité -En réel, un compte sans pièce d'identité vérifiée voit ses NOUVEAUX paiements mobile money refusés (`kyc_required`) au-delà d'un montant encaissé ou d'un nombre de jours après son premier paiement réel (aujourd'hui 1 000 000 F CFA ou 30 jours : lisez-les dans `getAccountKyc()`, ne les écrivez pas en dur). Rien de ce qui existe n'est bloqué, et la carte n'est pas concernée. `getAccountKyc()` donne l'état à montrer au marchand ; l'avis `account.kyc_required` (`onKycRequired`, contenu `event.kyc()`) arrive à 80 % du seuil, 7 jours avant l'échéance, puis au premier refus. Le responsable dépose sa pièce dans la console (`consoleUrl()`). +En réel, un compte sans pièce d'identité vérifiée voit ses NOUVEAUX paiements mobile money refusés (`kyc_required`) au-delà d'un montant encaissé ou d'un nombre de jours après son premier paiement réel (aujourd'hui 1 000 000 F CFA ou 30 jours : lisez-les dans `getAccountKyc()`, ne les écrivez pas en dur). Rien de ce qui existe n'est bloqué, et la carte n'est pas concernée. `getAccountKyc()` donne l'état à montrer au marchand ; l'avis `account.kyc_required` (`onKycRequired`, contenu `event.kyc()` : `reason()` est son déclencheur, `stage()` et `blockReason()` l'état, comme `getAccountKyc()`) arrive à 80 % du seuil, 7 jours avant l'échéance, puis au premier refus. Le responsable dépose sa pièce dans la console (`consoleUrl()`). ## La règle de relance diff --git a/examples/kotlin-spring/pom.xml b/examples/kotlin-spring/pom.xml index 1f68966..589440b 100644 --- a/examples/kotlin-spring/pom.xml +++ b/examples/kotlin-spring/pom.xml @@ -28,7 +28,7 @@ fr.technas technas-pay - 0.2.0 + 0.2.1 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