Démarrage rapide - KemyPay API

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é.

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.

Choisissez une catégorie

curl https://api.kemypay.com/v1/mobile-money/categories \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Créez votre service

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.

Vérifiez le prix

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" }'

Demandez un paiement

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 pour tous les résultats.

Recevez le webhook

Votre webhook_url reçoit mobile_money.collection.completed. Vérifiez sa signature, puis livrez la commande. Voir Webhooks.

Passer en production

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

Les encaissements, le calcul de prix et la devinette de l’opérateur sont en bêta pendant leur déploiement en production.

​Passer en production

Passer en production