Démarrer

Ikawaari est une plateforme d’infrastructure de paiement conçue pour l’Afrique et au-delà. Acceptez des paiements mobile money, par carte et par virement bancaire, puis opérez vos flux marchands à travers les paiements, les payouts, la facturation, le wallet et les intégrations d’applications.

remarque

Ikawaari expose actuellement plusieurs familles de routes API déjà implémentées. Dans cette introduction, les exemples se concentrent sur la famille de routes payment_intents actuellement implémentée pour les premiers flux de paiement. Voir Familles de routes pour la structure exacte.

Démarrage rapide

1. Créez un compte

Inscrivez-vous sur dashboard.ikawaari.com et terminez la vérification de votre activité.

2. Récupérez vos clés API

Accédez à Developers → API Keys dans le dashboard. Vous y trouverez deux environnements :

Environnement	Préfixe de clé	Usage
Sandbox	ik_test_	Test et développement
Live	ik_live_	Transactions de production

astuce

Commencez avec les clés sandbox. Aucun argent réel n’est déplacé en mode sandbox.

3. Installez un SDK

URL packages de production

Le lien du portail packages affiché dans cette documentation est injecté au build via la variable d’environnement `IKAWAARI_PACKAGES_PROD_URL`.

Aucune URL n’est configurée dans cet environnement de build.

cURL

# Aucune installation nécessaire — utilisez directement cURL
curl https://api.ikawaari.com/payment_intents \
  -H "Authorization: Bearer ik_test_your_key_here" \
  -H "Content-Type: application/json"

Node.js

npm install @ikawaari/sdk

import Ikawaari from '@ikawaari/sdk';

const ik = new Ikawaari({
  apiKey: 'ik_test_your_key_here',
});

Python

pip install ikawaari

import ikawaari
ik = ikawaari.Client(api_key="ik_test_your_key_here")

4. Créez votre premier paiement

cURL

curl -X POST https://api.ikawaari.com/payment_intents \
  -H "Authorization: Bearer ik_test_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "XOF",
    "payment_method_types": ["mobile_money"],
    "description": "Order #1234"
  }'

Node.js

const paymentIntent = await ik.payments.create({
  amount: 5000,
  currency: 'XOF',
  payment_method_types: ['mobile_money'],
  description: 'Order #1234',
});

console.log(paymentIntent.id); // pi_xxx...

Python

payment_intent = ik.payment_intents.create(
    amount=5000,
    currency="XOF",
    payment_method_types=["mobile_money"],
    description="Order #1234",
)

print(payment_intent.id)  # pi_xxx...

5. Traitez la réponse

Une réponse réussie retourne un objet PaymentIntent :

{
  "id": "pi_1a2b3c4d5e",
  "object": "payment_intent",
  "amount": 5000,
  "currency": "xof",
  "status": "requires_payment_method",
  "payment_method_types": ["mobile_money"],
  "description": "Order #1234",
  "created": 1708300800
}

Et ensuite ?

• Accepter un paiement — Guide d’intégration complet
• Mobile Money — Orange Money, MTN MoMo, Wave, etc.
• Webhooks — Soyez notifié quand les paiements se terminent
• Tests Sandbox — Testez sans argent réel
• Marchands — Manuel opératoire marchand
• Développeurs — Point d’entrée intégration
• Référence API — Documentation API complète