Metadata-Version: 2.4
Name: smartdevhub-core
Version: 0.1.0
Summary: SDK Python officiel de Smartdev Core — paiements (Wave, Orange Money), SMS/WhatsApp, vérification d'identité et campagnes pour l'Afrique de l'Ouest
Project-URL: Documentation, https://core.smartdevafrica.com/docs/
License: MIT
License-File: LICENSE
Keywords: africa,kyc,orange-money,payments,smartdev,sms,wave,xof
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.23.0
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# Smartdev Core — SDK Python

SDK officiel de [Smartdev Core](https://core.smartdevafrica.com/docs/) : paiements
(Wave, Orange Money), SMS/WhatsApp/Email, vérification d'identité progressive
et campagnes — une seule API pour opérer en Afrique de l'Ouest.

Généré depuis le contrat TypeSpec de l'API : le SDK ne peut pas dériver du serveur.

## Installation

```bash
pip install smartdevhub-core
```

Le paquet s'installe sous le nom `smartdevhub-core` et s'importe sous le nom
du produit : `smartdev_core`.

## Démarrage

```python
import os
from smartdev_core import SmartdevApi

core = SmartdevApi(token=os.environ["SMARTDEV_KEY"])  # sk_test_… ou sk_live_…

# Encaisser 15 000 XOF au Sénégal — le routing choisit le rail (Wave, Orange Money…)
core.pay.payment_intents_create(
    idempotency_key="ord-923-pay",
    country="SN",
    amount=15000,
    currency="XOF",
    reference="ORD-923",
    customer_msisdn="+221771234567",
)

# Notifier — WhatsApp d'abord, SMS en secours
core.relay.messages_send(
    idempotency_key="ord-923-notif",
    to="+221771234567",
    country="SN",
    channels=["whatsapp", "sms"],
    template="app.order.confirmed",
    variables={"ref": "ORD-923"},
)
```

Sous-clients : `pay`, `relay`, `trust`, `campaigns`, `platform`.
Client asynchrone : `AsyncSmartdevApi`.

## Environnements

| Clé | Base URL |
|---|---|
| `sk_test_…` | `https://sandbox.core.smartdevafrica.com` |
| `sk_live_…` | `https://api.core.smartdevafrica.com` |

Le sandbox simule les providers (paiement accepté/refusé, SMS livré/échoué,
KYC approuvé/rejeté) — aucun vrai débit, aucun vrai SMS.

## Documentation

Guide complet, erreurs, webhooks et idempotence : [core.smartdevafrica.com/docs](https://core.smartdevafrica.com/docs/).

## Licence

[MIT](./LICENSE)
