Introduction

nyole encaisse pour vous en Afrique : Mobile Money (Orange Money, Wave, MTN MoMo, Moov…) et carte bancaire, par une seule intégration. La différence avec un orchestrateur classique tient en une phrase : vous n’ouvrez aucun compte agrégateur. nyole encaisse avec ses propres passerelles, garde le produit de vos ventes sur votre solde, et vous le reverse sur votre Mobile Money quand vous le demandez.

Ce que vous n'avez pas à faire

Pas de dossier PayDunya, Wave Business, Hub2 ou Stripe à monter. Pas de clés d’agrégateur à brancher, pas de contrat à négocier opérateur par opérateur. Vous créez un espace, vous encaissez.

Ce que fait l’API

Sessions de paiement

Créez une session en un appel, redirigez votre client vers la page de paiement hébergée, récupérez le résultat par webhook ou en interrogeant le statut.

Liens de paiement

Générez un lien à partager par WhatsApp, e-mail ou réseaux sociaux, sans écrire une ligne de code côté client.

Solde et reversements

Chaque paiement réussi alimente votre solde. Le reversement part vers votre Mobile Money : vous recevez au moins 500 F CFA à chaque fois.

Webhooks signés

Chaque changement de statut est poussé vers votre serveur avec une signature HMAC-SHA256 que vous vérifiez.

Base URL

Toutes les requêtes se font en HTTPS vers l’adresse ci-dessous. Les endpoints versionnés sont préfixés par /v1.

Base URL

https://app.nyole.com/api

Format des réponses

Les réponses sont en JSON. Une erreur renvoie un code HTTP 4xx ou 5xx et un objet { "error": "..." } (ou { "success": false, "message": "..." } sur les endpoints de la page de paiement). Les montants sont des entiers dans la plus petite unité courante de la devise : 5000 vaut 5 000 XOF.

Environnements

Il n’y a pas d’hôte « sandbox » séparé : ce sont vos clés qui font le monde. Chaque espace a deux jeux de clés, af_test_... pour construire et vérifier votre intégration sans qu’aucun argent ne circule (l’issue du paiement se choisit sur la page), af_live_... pour encaisser réellement. Les données de test restent à l’écart de la production. Tout est décrit dans Mode test.

Numéros de test

En mode test, n’importe quel numéro valide convient : l’issue se choisit sur la page de paiement.

Encaisser d’abord, retirer ensuite

Vous pouvez encaisser dès la création de votre espace. Pour retirer votre solde, nyole doit d’abord vérifier votre identité : c’est une obligation réglementaire, elle se règle une fois depuis votre espace, à la page Vérification d’identité. Tant que le dossier n’est pas validé, l’argent continue d’entrer et reste sur votre solde.