Construisez des expériences
de paiement fluides.
Une API moderne pour accepter et piloter vos paiements Wave, Orange Money et cartes depuis vos applications.
Bienvenue
Niania Pay orchestre les APIs des prestataires configurés. Les fonds et l'exécution du paiement restent chez le prestataire.
Démarrage rapide
Créez votre compte, générez une clé Sandbox depuis Profil marchand → Developer Platform, puis utilisez-la uniquement côté serveur.
- Créez une demande de paiement.
- Redirigez le client vers
checkout_url. - Suivez le statut avec l'API ou votre webhook.
Authentification
Ajoutez votre clé secrète dans l'en-tête Authorization.
Authorization: Bearer np_sk_test_votre_cleCréer un paiement
Initiez un checkout avec cet endpoint. La réponse contient checkout_url : redirigez votre client vers cette URL.
POST /api/v1/payments
{
"amount": 15000,
"currency": "XOF",
"description": "Commande #4587",
"customer": { "phone": "77XXXXXXX" },
"success_url": "https://exemple.sn/success",
"cancel_url": "https://exemple.sn/cancel",
"webhook_url": "https://exemple.sn/webhook"
}Exemple serveur :
curl -X POST https://votre-domaine/api/v1/payments \
-H "Authorization: Bearer np_sk_test_..." -H "Content-Type: application/json" \
-d '{"amount":15000,"currency":"XOF","method":"wave","reference":"ORDER-4587"}'Envoyer un SMS
Chaque SMS consomme vos crédits. Utilisez votre clé secrète côté serveur uniquement, jamais dans le navigateur ou l’application mobile.
POST /api/v1/sms/messages
{"to":"+221771234567","sender":"NIANIA","message":"Votre code est 123456"}Achetez des crédits avec POST /api/v1/sms/credits/purchase, puis consultez votre solde avec GET /api/v1/balance.
Webhooks
Niania Pay relaie les changements de statut vers votre URL. Vérifiez toujours la signature HMAC dans l'en-tête X-Niania-Signature avant de traiter l'événement.
SDK & applications mobiles
Pour Android, Flutter ou iOS, votre application doit appeler votre backend, et non exposer la secret key. Votre backend utilise l'API Niania Pay puis renvoie la checkout_url à l'application.
Les SDK natifs et les connecteurs partenaires seront ajoutés progressivement. L'API REST actuelle est la base commune à toutes les plateformes.