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.2.0</version>
<version>v0.2.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.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()`.
Expand Down
6 changes: 3 additions & 3 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.2.0</version>
<version>v0.2.1</version>
</dependency>
```

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 :
Expand Down Expand Up @@ -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

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.2.0</version>
<version>0.2.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.2.0</version>
<version>0.2.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.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.

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.2.0</version>
<version>0.2.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.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 « . »
Expand Down
15 changes: 12 additions & 3 deletions src/main/java/fr/technas/pay/model/KycNotice.java
Original file line number Diff line number Diff line change
Expand Up @@ -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}
* <p>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"));
}
}
22 changes: 22 additions & 0 deletions src/test/java/fr/technas/pay/SeuilKycTest.java
Original file line number Diff line number Diff line change
Expand Up @@ -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<KycNotice> 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
Expand Down
Loading