Metadata-Version: 2.4
Name: cauris
Version: 0.2.0
Summary: SDK Python pour l'API de paiement Cauris — Mobile Money en Afrique
Author-email: Cauris <eyikeolivier@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://cauris.dev
Project-URL: Documentation, https://docs.cauris.dev
Project-URL: Repository, https://github.com/dreyike/cauris-python
Keywords: payment,mobile-money,africa,api,orange-money,mtn
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28

# Cauris — SDK Python

API de paiement Mobile Money pour l'Afrique. Orange Money, MTN, 9 pays.

## Installation

```bash
pip install cauris
```

## Recevoir un paiement (3 lignes)

```python
import cauris

cauris.api_key = "ck_test_..."

charge = cauris.Charge.create(
    amount=5000,
    phone="237691234567"
)

print(charge.id)      # "d6ac3af6-..."
print(charge.status)  # "pending"
```

Le client recoit une notification USSD. Il confirme. Tu recois un webhook.

## Verifier un paiement

```python
charge = cauris.Charge.retrieve("d6ac3af6-...")
print(charge.status)  # "success" | "pending" | "failed"
```

## Parametres

| Param | Type | Requis | Description |
|---|---|---|---|
| `amount` | int | oui | Montant en unite minimale (5000 = 5000 XAF) |
| `phone` | str | oui | Numero international (237691234567) |
| `currency` | str | non | Defaut: XAF. Valeurs: XAF, XOF, CDF, UGX, GNF |
| `notify_url` | str | non | URL webhook appelee a la confirmation |
| `metadata` | dict | non | Donnees libres (ex: order_id) |

## Pays supportes

Cameroun, Senegal, Congo-Brazzaville, Congo-Kinshasa, Uganda, Benin, Guinee-Conakry, Gabon.

## Liens

- Site : https://app-cauris.vercel.app
- npm : https://www.npmjs.com/package/cauris
