Développeurs

SDK & plugins
Intègre Monniz en quelques lignes

Bibliothèques officielles PHP, Node.js et Python, et plugin WooCommerce pour l'API Monniz Business.

Référence API interactiveCollection Postman

Les bibliothèques

Disponibilité

Les SDK PHP, Node.js et Python seront publiés sur Packagist, npm et PyPI. Le plugin WooCommerce est disponible dès maintenant. L'API HTTP est utilisable directement — voir la référence interactive.

Les trois SDK exposent les mêmes services : payments, paymentLinks, prepaid, issuing et la vérification de signature des webhooks. Les noms de méthodes suivent les conventions de chaque langage (createCardholder, cardholders.create, create_cardholder).

SDK PHP

PHP 8.1+

Installation :

composer require monniz/monniz-php

Bientôt sur Packagist.

SDK Node.js

Node 18+

Installation :

npm install monniz

Bientôt sur npm.

SDK Python

Python 3.9+

Installation :

pip install monniz

Bientôt sur PyPI.

Plugin WooCommerce

WordPress 6+ · WooCommerce 8+

Installation :

Téléverser monniz-for-woocommerce.zip

Disponible dès maintenant.

Télécharger le zip

Créer un paiement

Le même appel dans les trois langages.

PHP
$monniz = new \Monniz\MonnizClient('mnz_sk_test_...');

$payment = $monniz->payments->create([
    'amount'         => '15000',
    'currency'       => 'XOF',
    'payment_method' => 'moov-benin',
    'customer'       => ['name' => 'Aminata', 'phone' => '90165245'],
]);

echo $payment['next_action']['message'];
Node.js
const { MonnizClient } = require('monniz')

const monniz = new MonnizClient('mnz_sk_test_...')

const payment = await monniz.payments.create({
  amount: '15000',
  currency: 'XOF',
  payment_method: 'moov-benin',
  customer: { name: 'Aminata', phone: '90165245' },
})

res.json({ message: payment.next_action.message })
Python
from monniz import MonnizClient

monniz = MonnizClient("mnz_sk_test_...")

payment = monniz.payments.create({
    "amount": "15000",
    "currency": "XOF",
    "payment_method": "moov-benin",
    "customer": {"name": "Aminata", "phone": "90165245"},
})

return {"message": payment["next_action"]["message"]}

amount et payment_method sont obligatoires, customer.phone aussi sauf carte et crypto. La réponse porte payment_id (mzp_…, ou ta propre valeur de 8 caractères minimum) ; rejouer le même payment_id renvoie le paiement existant.

Vérifier un webhook

Chaque livraison porte l'en-tête Monniz-Signature: t=…,v1=… — HMAC-SHA256 de la chaîne {t}.{corps brut}. constructEvent vérifie la signature et l'horodatage, puis rend l'événement décodé.

PHP
use Monniz\Webhook;

$event = Webhook::constructEvent(
    file_get_contents('php://input'),
    $_SERVER['HTTP_MONNIZ_SIGNATURE'],
    'whsec_...',
);

if ($event['type'] === 'payment.succeeded') {
    // Marque la commande comme payée
}

Plugin WooCommerce

Le plugin ajoute Monniz comme moyen de paiement WooCommerce. La commande passe en processing à la réception du webhook signé, et en refunded quand le paiement est remboursé.

  1. Extensions → Ajouter → Téléverser le zip → Activer.
  2. WooCommerce → Réglages → Paiements → Monniz → colle ta clé API.
  3. Renseigne l'URL de webhook complète https://ton-site.com/?wc-api=monniz_webhook dans ton dashboard, puis colle le secret whsec_… dans les réglages du plugin.

Aller plus loin

API Paiements

Encaisser Mobile Money et carte depuis ton site.

API Prépayés

Revendre recharges, eSIM et cartes cadeaux.

API Cartes

Émettre des cartes virtuelles pour tes clients.

Prêt à encaisser depuis ton site ?

Ouvre un compte, génère une clé de test, encaisse ton premier paiement aujourd'hui.

Ouvrir un compteExplorer la doc développeurs
SDK & plugins — Documentation développeurs | Monniz Business