> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kemypay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

> De votre clé API à votre premier paiement

Ce guide vous mène de zéro à un premier paiement de test. Utilisez une **clé de test** (`sk_test_…`) : aucun argent ne bouge, et votre service peut encaisser tout de suite, avant même que notre équipe l'ait validé.

**1. Obtenez vos clés API**

Dans votre tableau de bord, créez une clé de test et une clé de production, et ajoutez les adresses IP de vos serveurs à la liste autorisée. Voir [Authentification](https://docs.kemypay.com/fr/authentication.md).

**2. Choisissez une catégorie**

```bash theme={null}
curl https://api.kemypay.com/v1/mobile-money/categories \
  -H "Authorization: Bearer sk_test_YOUR_KEY"
```

**3. Créez votre service**

```bash theme={null}
curl -X POST https://api.kemypay.com/v1/mobile-money/services \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Afroyamo",
    "category": "dating",
    "description": "Dating app for the African diaspora. Premium subscriptions paid by mobile money.",
    "url": "https://afroyamo.com",
    "support_email": "support@afroyamo.com",
    "support_phone": "+237670000000",
    "webhook_url": "https://api.afroyamo.com/kemypay/webhooks"
  }'
```

La réponse contient le `code` du service et son **`webhook_secret`. Enregistrez le secret tout de suite : il n'est montré qu'une seule fois.**

**4. Vérifiez le prix**

```bash theme={null}
curl -X POST https://api.kemypay.com/v1/mobile-money/quote \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "operator": "MTN_CMR", "currency": "XAF", "amount": "1000", "fee_bearer": "customer" }'
```

**5. Demandez un paiement**

```bash theme={null}
curl -X POST https://api.kemypay.com/v1/mobile-money/collections \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "SERVICE_CODE",
    "amount": "1000",
    "currency": "XAF",
    "operator": "MTN_CMR",
    "phone_number": "237670000789",
    "reference": "order-0001",
    "description": "Afroyamo Premium"
  }'
```

En mode test, un numéro qui se termine par `789` réussit. Voir [Mode test](https://docs.kemypay.com/fr/test-mode.md) pour tous les résultats.

**6. Recevez le webhook**

Votre `webhook_url` reçoit `mobile_money.collection.completed`. Vérifiez sa signature, puis livrez la commande. Voir [Webhooks](https://docs.kemypay.com/fr/guides/webhooks.md).

## Passer en production

1. Attendez que votre service soit `active` (nous vous prévenons par e-mail quand il est validé).
2. Passez à votre clé `sk_live_…`. Rien d'autre ne change dans votre code.
3. Utilisez de vrais numéros : vos clients reçoivent une vraie demande et paient avec de l'argent réel.

> [!NOTE]
>
> Les encaissements, le calcul de prix et la devinette de l'opérateur sont en **bêta** pendant leur déploiement en production.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.