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
4 changes: 2 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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"
```


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

Expand Down
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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

Expand Down
2 changes: 1 addition & 1 deletion src/technas_pay/_version.py
Original file line number Diff line number Diff line change
@@ -1 +1 @@
__version__ = "0.5.0"
__version__ = "0.5.1"
12 changes: 12 additions & 0 deletions src/technas_pay/webhooks.py
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand All @@ -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)
Expand Down Expand Up @@ -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(
Expand Down
21 changes: 21 additions & 0 deletions tests/test_webhooks.py
Original file line number Diff line number Diff line change
Expand Up @@ -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
Loading