Guide de démarrage rapide

Recevez votre premier paiement en 5 minutes

Suivez ce guide étape par étape pour intégrer Simiz dans votre application.

1
1 min

Créer un compte

Inscrivez-vous gratuitement et accédez à votre dashboard.

2
30 sec

Obtenir vos clés API

Récupérez vos clés de test depuis le dashboard.

3
2 min

Intégrer le SDK

Installez notre SDK ou utilisez l'API REST directement.

4
1 min

Tester en sandbox

Effectuez votre premier paiement de test.

1

Créer votre compte Simiz

Commencez par créer un compte gratuit. Aucune carte bancaire n'est requise pour commencer.

2

Obtenir vos clés API

Une fois connecté, rendez-vous dans Paramètres → Clés API pour récupérer vos clés.

Clé de test (Sandbox)

sk_test_xxxxxxxxxxxx

Utilisez cette clé pour les tests. Aucun paiement réel ne sera effectué.

Clé de production (Live)

sk_live_xxxxxxxxxxxx

Utilisez cette clé pour les paiements réels après validation KYB.

Important: Ne partagez jamais vos clés secrètes. Gardez-les côté serveur uniquement.

3

Intégrer le SDK

Installation

npm install @simiz/node-sdk

Configuration

import { Simiz } from '@simiz/node-sdk';

// Initialize with your test key
const simiz = new Simiz(process.env.SIMIZ_SECRET_KEY);

Créer votre premier paiement

// Créer une transaction Mobile Money
const transaction = await simiz.transactions.create({
  amount: 5000,              // 5000 XAF
  currency: 'XAF',
  payment_method: 'ORANGE_MONEY',
  payer: {
    phone: '237690000000',   // Numéro du client
    name: 'John Doe',
  },
  description: 'Commande #12345',
  callback_url: 'https://votre-site.com/webhooks/simiz',
  return_url: 'https://votre-site.com/success',
});

console.log(transaction.id);          // tx_xxx
console.log(transaction.status);      // PENDING
console.log(transaction.payment_url); // URL pour le client
4

Tester en mode Sandbox

Utilisez ces numéros de test pour simuler différents scénarios de paiement :

Numéro de testOpérateurRésultat
237690000001Orange MoneySuccès
237670000001MTN MoMoSuccès
237690000002Orange MoneyÉchec - Solde insuffisant
237690000003Orange MoneyTimeout

Félicitations !

Vous avez intégré Simiz avec succès. Voici les prochaines étapes :