Démarrage rapide

Cinq minutes suffisent pour encaisser un premier paiement.

Créez votre espace.

Créez un compte et ouvrez votre espace : nom de votre activité, site ou page où vous vendez. Aucune passerelle à brancher, aucune clé d’agrégateur à fournir, nyole encaisse avec les siennes. Dans Moyens de paiement, vous voyez, pays par pays, ce que vos clients pourront utiliser.
Récupérez vos clés API.

Dans API et journaux, vous trouvez votre clé publique af_live_pub_... et votre clé secrète af_live_sec_.... La clé secrète authentifie vos appels serveur : ne la mettez jamais dans une page web ou une application mobile.

Créez une session de paiement.

curl -X POST https://app.nyole.com/api/v1/checkout/sessions \
  -H "Authorization: Bearer af_live_sec_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: commande-1042" \
  -d '{
    "amount": 5000,
    "currency": "XOF",
    "customer_name": "Awa Koné",
    "customer_email": "[email protected]",
    "customer_phone": "+2250700000000",
    "description": "Commande #1042",
    "success_url": "https://maboutique.com/merci",
    "cancel_url": "https://maboutique.com/panier",
    "metadata": { "order_id": "1042" }
  }'

La réponse contient l’adresse de la page de paiement : redirigez-y votre client.

{
  "id": "cmf3k2p1x0001abcd9e8f7g6h",
  "object": "checkout.session",
  "url": "https://app.nyole.com/checkout/cmf3k2p1x0001abcd9e8f7g6h",
  "order_id": "CS-MF3K2A-9X1QZ",
  "amount": 5000,
  "currency": "XOF",
  "status": "pending",
  "created": "2026-09-02T10:15:00.000Z"
}

Recevez la confirmation.

Renseignez l’URL de votre serveur dans API et journaux, ou par l’API (voir Webhooks). Dès que le paiement aboutit, nyole envoie l’événement payment.completed, signé. Vous pouvez aussi interroger le statut de la session à tout moment.
Passez en production.

Remplacez vos clés af_test_... par vos clés af_live_.... Pour retirer votre solde, complétez votre vérification d’identité : elle est obligatoire, et elle ne se fait qu’une fois. Vous pouvez encaisser sans attendre qu’elle soit validée.