From e68333896623ba4f60e59ebb6de80acbf3c62883 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:58 +0100 Subject: [PATCH] =?UTF-8?q?feat(kyc)=20:=20l'avis=20account.kyc=5Frequired?= =?UTF-8?q?=20porte=20l'=C3=A9tat=20du=20compte=20(stage,=20block=5Freason?= =?UTF-8?q?,=20days=5Felapsed,=20grace=5Fdays,=20first=5Fcollected=5Fat)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Champs facultatifs : None sur un avis plus ancien. reason ne change pas de sens. Version 0.5.1. --- AGENTS.md | 4 ++-- CHANGELOG.md | 4 ++++ README.md | 4 ++-- src/technas_pay/_version.py | 2 +- src/technas_pay/webhooks.py | 12 ++++++++++++ tests/test_webhooks.py | 21 +++++++++++++++++++++ 6 files changed, 42 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 98424c6..9b74746 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,7 +13,7 @@ Même API, mêmes règles que le SDK TypeScript `@technas/pay-next` : seuls les ## Installer ```bash -pip install "technas-pay @ git+https://github.com/Technas-Organization/technas-pay-python@v0.5.0" +pip install "technas-pay @ git+https://github.com/Technas-Organization/technas-pay-python@v0.5.1" ``` @@ -99,7 +99,7 @@ Ne réécrivez pas de routes : `pay.app_routes(authorize=..., resolve_order=..., - **La règle** : 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à de 1 000 000 F CFA encaissés en cumul ou de 30 jours après son premier paiement réel encaissé. Rien de ce qui existe n'est bloqué (paiement en cours, remboursement, reversement, lecture). La carte n'est pas concernée. Le responsable dépose sa pièce dans la console (`console_url`). - **Afficher l'état** : `pay.get_account_kyc()` dans l'espace d'administration du MARCHAND (jamais au client final) : `stage` (`ok`, `soon`, `blocked`, `verified`, `not_applicable`), `collected_xof` / `threshold_xof`, `deadline`, `console_url`. Une valeur inconnue de `stage`, `level` ou `reason` est une chaîne : traitez-la comme « à vérifier », sans planter. -- **Prévenir le responsable** : branchez `WebhookHandlers(on_kyc_required=...)` (avis `account.kyc_required`, à 80 % du seuil, 7 jours avant l'échéance, puis au premier refus) ; `event.kyc_required.reason` vaut `amount_80`, `deadline_7d` ou `blocked`. +- **Prévenir le responsable** : branchez `WebhookHandlers(on_kyc_required=...)` (avis `account.kyc_required`, à 80 % du seuil, 7 jours avant l'échéance, puis au premier refus) ; `event.kyc_required.reason` vaut `amount_80`, `deadline_7d` ou `blocked`. L'avis porte aussi `stage`, `block_reason` (`amount` | `duration`), `days_elapsed`, `grace_days`, `first_collected_at`, comme `get_account_kyc()` ; tous facultatifs (`None` sur un avis plus ancien). - **Sur `kyc_required`** : proposez la carte, ou expliquez au client que le paiement mobile money n'est pas disponible pour le moment. **Ne réessayez jamais.** - **Les chiffres viennent de l'API** (`threshold_xof`, `grace_days`, `warn_from_xof`) : n'écrivez jamais 1 000 000 ni 30 dans le code. diff --git a/CHANGELOG.md b/CHANGELOG.md index 3c9fea2..1ada2b5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +## 0.5.1 — 2026-11-15 + +Avis `account.kyc_required` : `KycRequired` porte aussi l'état du compte, comme `get_account_kyc()` : `stage`, `block_reason` (`amount` | `duration`), `days_elapsed`, `grace_days`, `first_collected_at`. Tous facultatifs (`None` sur un avis plus ancien). `reason` ne change pas de sens. + ## 0.5.0 — 2026-11-15 Seuil d'identité : `get_account_kyc()` (`GET /v1/account/kyc`) rend un `AccountKyc` (`stage`, `level`, `collected_xof`, `threshold_xof`, `grace_days`, `deadline`, `console_url`…). Avis `account.kyc_required` : fonction `on_kyc_required`, contenu typé `event.kyc_required` (`KycRequired`). Erreurs `kyc_required` et `contract_required` (409, non rejouables) : `details.console_url` et `details.version`. Les valeurs inconnues de `stage`, `level` et `reason` sont gardées telles quelles. diff --git a/README.md b/README.md index 180f4dc..227a673 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ C'est la même API que le SDK TypeScript [`@technas/pay-next`](https://github.co ## 1. Installer ```bash -pip install "technas-pay @ git+https://github.com/Technas-Organization/technas-pay-python@v0.5.0" +pip install "technas-pay @ git+https://github.com/Technas-Organization/technas-pay-python@v0.5.1" ``` Seule dépendance : `httpx`. Python 3.9 ou plus récent. @@ -148,7 +148,7 @@ if kyc.stage in ("soon", "blocked"): show_banner(f"{kyc.collected_xof} / {kyc.threshold_xof} F CFA, échéance {kyc.deadline}", kyc.console_url) ``` -Les chiffres (seuil, délai) viennent de l'API (`threshold_xof`, `grace_days`) : ne les écrivez jamais en dur. Branchez `on_kyc_required` pour prévenir le responsable : l'avis `account.kyc_required` part à 80 % du seuil (`reason="amount_80"`), 7 jours avant l'échéance (`"deadline_7d"`), puis au premier refus (`"blocked"`), avec `event.kyc_required.collected_xof`, `threshold_xof`, `deadline`, `blocked`, `console_url`. +Les chiffres (seuil, délai) viennent de l'API (`threshold_xof`, `grace_days`) : ne les écrivez jamais en dur. Branchez `on_kyc_required` pour prévenir le responsable : l'avis `account.kyc_required` part à 80 % du seuil (`reason="amount_80"`), 7 jours avant l'échéance (`"deadline_7d"`), puis au premier refus (`"blocked"`), avec `event.kyc_required.collected_xof`, `threshold_xof`, `deadline`, `blocked`, `console_url`. L'avis porte aussi l'état du compte, comme `get_account_kyc()` : `stage`, `block_reason` (`amount` ou `duration`), `days_elapsed`, `grace_days`, `first_collected_at` (facultatifs : `None` sur un avis plus ancien). ## La règle de relance diff --git a/src/technas_pay/_version.py b/src/technas_pay/_version.py index 3d18726..dd9b22c 100644 --- a/src/technas_pay/_version.py +++ b/src/technas_pay/_version.py @@ -1 +1 @@ -__version__ = "0.5.0" +__version__ = "0.5.1" diff --git a/src/technas_pay/webhooks.py b/src/technas_pay/webhooks.py index 3d514df..bb7824d 100644 --- a/src/technas_pay/webhooks.py +++ b/src/technas_pay/webhooks.py @@ -79,6 +79,11 @@ class KycRequired: ``reason`` : ``amount_80`` (80 % du seuil encaissés), ``deadline_7d`` (échéance dans 7 jours), ``blocked`` (premier refus). Une valeur que cette version ne connaît pas est gardée telle quelle. Prévenez le RESPONSABLE : il dépose sa pièce d'identité sur ``console_url``. + + L'avis porte aussi l'état du compte, comme ``get_account_kyc`` : ``stage`` (``ok``, ``soon``, + ``blocked``, ``verified``, ``not_applicable``), ``block_reason`` (``amount`` ou ``duration``, + si bloqué), ``days_elapsed``, ``grace_days``, ``first_collected_at``. Tous facultatifs : un + avis plus ancien ne les porte pas, ils valent alors ``None``. """ reason: Optional[str] @@ -87,6 +92,11 @@ class KycRequired: deadline: Optional[str] blocked: bool console_url: Optional[str] + stage: Optional[str] = None + block_reason: Optional[str] = None + days_elapsed: Optional[int] = None + grace_days: Optional[int] = None + first_collected_at: Optional[str] = None @dataclass(frozen=True) @@ -140,6 +150,8 @@ def parse_event(raw: Any) -> Event: return Event(**base, kyc_required=KycRequired( reason=d.get("reason"), collected_xof=d.get("collected_xof"), threshold_xof=d.get("threshold_xof"), deadline=d.get("deadline"), blocked=bool(d.get("blocked")), console_url=d.get("console_url"), + stage=d.get("stage"), block_reason=d.get("block_reason"), days_elapsed=d.get("days_elapsed"), + grace_days=d.get("grace_days"), first_collected_at=d.get("first_collected_at"), )) if t == "balance.topped_up": return Event(**base, top_up=TopUpInfo( diff --git a/tests/test_webhooks.py b/tests/test_webhooks.py index 967a64a..607fb0e 100644 --- a/tests/test_webhooks.py +++ b/tests/test_webhooks.py @@ -138,3 +138,24 @@ def test_avis_kyc_required_signe_contenu_type(): "data": dict(data, reason="blocked", blocked=True, deadline=None)}) ev = TechnasPay(SECRET).verify_webhook(blocked, sign(blocked, WEBHOOK_SECRET)) assert ev.kyc_required.blocked and ev.kyc_required.reason == "blocked" and ev.kyc_required.deadline is None + # Avis ancien (sans l'état du compte) : les nouveaux champs valent None. + assert seen[0].kyc_required.stage is None and seen[0].kyc_required.block_reason is None + assert seen[0].kyc_required.days_elapsed is None and seen[0].kyc_required.grace_days is None + assert seen[0].kyc_required.first_collected_at is None + + +def test_avis_kyc_required_porte_l_etat_du_compte(): + data = {"reason": "blocked", "collected_xof": 1000000, "threshold_xof": 1000000, "deadline": None, + "blocked": True, "console_url": "https://console.technas.test/identite", + "stage": "blocked", "block_reason": "duration", "days_elapsed": 31, "grace_days": 30, + "first_collected_at": "2026-10-15T09:00:00Z"} + body = json.dumps({"id": "evt_kyc2", "type": "account.kyc_required", "created_at": "x", "data": data}) + k = TechnasPay(SECRET).verify_webhook(body, sign(body, WEBHOOK_SECRET)).kyc_required + assert k == KycRequired(**data) + assert (k.stage, k.block_reason, k.days_elapsed, k.grace_days, k.first_collected_at) == ( + "blocked", "duration", 31, 30, "2026-10-15T09:00:00Z") + nuls = json.dumps({"id": "evt_kyc3", "type": "account.kyc_required", "created_at": "x", + "data": dict(data, stage="ok", block_reason=None, days_elapsed=None, + grace_days=None, first_collected_at=None)}) + k = TechnasPay(SECRET).verify_webhook(nuls, sign(nuls, WEBHOOK_SECRET)).kyc_required + assert k.stage == "ok" and k.block_reason is None and k.days_elapsed is None and k.first_collected_at is None