NIANIA PAY API

Construisez des expériences
de paiement fluides.

Une API moderne pour accepter et piloter vos paiements Wave, Orange Money et cartes depuis vos applications.

✓Environnement Sandbox actif — testez sans risque avec vos clés de développement.

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.

  1. Créez une demande de paiement.
  2. Redirigez le client vers checkout_url.
  3. 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_cle

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

Architecture recommandéeApplication mobile → votre serveur → API Niania Pay → Wave / Orange Money / carte.

Les SDK natifs et les connecteurs partenaires seront ajoutés progressivement. L'API REST actuelle est la base commune à toutes les plateformes.