Smart Solution Financial platform for ambitious African businesses
HELP CENTER & DOCUMENTATION

MaishaPay Help & Product Support

Comprehensive integration guides, 24/7 interactive AI Assistant, and technical documentation for merchants, accountants, and developers.

PAPAPU • AI COMPANION 24/7

Your Smart MaishaPay AI

Talk or type to Papapu to grow your business, track your sales, use your Smart POS Terminal, or integrate MaishaPay APIs.

Papapu AI Mascot
Papapu AI Companion
Connected Live • Fintech Specialist
WhatsApp Support
Papapu

Hello, I am Papapu, your MaishaPay assistant. ⭐

How can I help you? I can help you track your sales, analyze transactions, manage payments, and better understand your business activity.

💡 Click one of the suggested topics above, type in the box, or click the Microphone to talk directly!

Papapu is thinking
Papapu is thinking...
Powered by official MaishaPay knowledge • Speech to Text & Natural Audio Voice Encrypted & secure data
PRODUCT DOCUMENTATION

Detailed Documentation for 11 MaishaPay Products

Explore user guides, features, and support workflows for each of our payment collection and financial management tools.

MATÉRIEL PHYSIQUE

MaishaPay Smart POS Terminal

Le terminal MaishaPay Smart POS est un appareil de paiement électronique professionnel conçu pour équiper les boutiques, supermarchés, restaurants, hôtels et stations-services en Afrique.

Moyens de paiement acceptés Cartes Visa, Mastercard (puce EMV, bande, sans contact NFC) et Mobile Money (M-Pesa, Orange, Airtel, MTN).
Connectivité 4G + Wi-Fi Carte SIM 4G multi-opérateurs pré-activée incluse avec basculement automatique sur le réseau Wi-Fi.
Imprimante thermique rapide Impression instantanée du reçu client et commerçant ou transmission par SMS / WhatsApp.
Sécurité PCI-PTS Appareil certifié aux standards bancaires avec clavier PIN sécurisé et module cryptographique inviolable.

🛠️ Utilisation et Procédures de Support :

  • Démarrage & Encaissement : Allumez le terminal, tapez le montant de la vente, invitez le client à insérer sa carte ou à flasher le QR code avec son téléphone.
  • Clôture de caisse : Depuis le menu « Rapport », imprimez le récapitulatif journalier (Z-report) pour votre réconciliation comptable.
  • Assistance & Garantie : Support technique disponible 24/7. En cas de dysfonctionnement matériel, un remplacement d'appareil sous 24h est garanti en RDC et au Congo-Brazzaville.
100% SMARTPHONE

MaishaPay M-Terminal Virtual

Le M-Terminal Virtual est une innovation MaishaPay permettant à tout commerçant d'encaisser ses clients directement depuis un simple smartphone Android, sans aucun appareil POS physique dédié.

Flash QR Code Génération d'un code QR unique sur l'écran du smartphone pour un paiement instantané par smartphone client.
Paiement USSD Offline Aucune connexion Internet obligatoire : un simple téléphone suffit pour valider la transaction par code secret.
Sans contact NFC Tap Le client approche sa carte bancaire au dos du smartphone du commerçant pour valider l'achat.
Zéro coût matériel Pas de caution, pas de location mensuelle, activation immédiate après téléchargement.

Cas d'usage préconisés :

Idéal pour les livreurs à domicile, chauffeurs de taxi, marchands ambulants, boutiques éphémères et artisans nomades.

VENTE À DISTANCE

Lien de paiement (Payment Links)

Les liens de paiement permettent d'encaisser des clients à distance sans avoir de site e-commerce. Vous créez un lien en quelques secondes et vous le partagez sur n'importe quel canal de messagerie ou réseau social.

Comment créer et partager un lien :

  1. Rendez-vous dans votre espace marchand > Liens de paiement.
  2. Cliquez sur Nouveau lien : indiquez le titre du produit, le montant (fixe ou personnalisable), la devise et une date limite de validité facultative.
  3. Copiez l'URL générée et collez-la dans votre échange WhatsApp, SMS, e-mail ou sur votre bio Instagram.
  4. Le client clique, sélectionne son moyen de paiement préféré et règle la somme. Vous recevez un avis de crédit immédiat.
COMMERCE EN LIGNE

MaishaPay Checkout Web

MaishaPay Checkout est notre interface de paiement prête à l'emploi conçue pour maximiser votre taux de conversion en e-commerce. Elle s'adapte à tous les écrans (mobile, tablette, ordinateur) et gère automatiquement la détection des opérateurs locaux.

Étapes d'une transaction Checkout :

  1. Initiation : Votre site soumet le formulaire Checkout vers notre passerelle avec la référence unique et les montants.
  2. Expérience client : L'acheteur visualise le récapitulatif clair de sa commande et sélectionne son opérateur (M-Pesa, Orange, Airtel, MTN, Visa, etc.).
  3. Validation sécurisée : Le client valide par invite USSD sur son téléphone ou saisie sécurisée 3D-Secure pour les cartes bancaires.
  4. Webhook & Redirection : Votre serveur reçoit la notification instantanée de confirmation et l'acheteur est redirigé vers votre page de succès.
INFRASTRUCTURE CLOUD

Payment Gateway (Passerelle Unifiée)

La passerelle de paiement MaishaPay fédère les réseaux bancaires et de télécommunications africains sous une API REST unique et standardisée. Elle est conçue pour les organisations traitant des volumes élevés de transactions exigeant une disponibilité 99,99%.

Elle intègre le routage intelligent multi-opérateurs, la redondance des liens télécoms et une gestion automatisée des réessais en cas d'encombrement réseau.

ACTIFS NUMÉRIQUES

Paiements Crypto & Web3

Acceptez les paiements en cryptomonnaies et stablecoins sans risque de volatilité. MaishaPay supporte USDT (sur TRON TRC-20 et Ethereum ERC-20), USDC et Bitcoin (BTC).

Vous pouvez choisir d'encaisser directement en stablecoins sur un portefeuille non-custodial ou demander la conversion automatique et instantanée en monnaies fiduciaires (USD, CDF, XAF) sur votre solde marchand.

PROGRAMME SPÉCIAL

Solutions MaishaPay pour Startups

Le programme Startups de MaishaPay soutient les entreprises technologiques émergentes et créateurs d'applications en Afrique. Il propose :

  • Accès illimité et prioritaire à l'environnement Sandbox.
  • Tarification dégressive au volume pour stimuler votre amorçage sans coûts fixes.
  • Canal direct avec nos architectes logiciels (Slack / WhatsApp) pour vous accompagner lors du déploiement.
COMMERCE CONVERSATIONNEL

MaishaPay for WhatsApp

Intégrez l'encaissement directement au sein de WhatsApp pour vendre dans les conversations de vos clients. Vous pouvez envoyer des factures interactives par message et automatiser les confirmations d'achat avec remise de reçu PDF sans que le client ne quitte sa messagerie.

ENVIRONNEMENT DE TEST

Documentation Sandbox (Bac à sable)

Le mode Sandbox vous permet de tester l'ensemble des scénarios de paiement (succès, refus de solde, annulation, timeout) sans engager de vrais fonds monétaires.

Clés de Test gatewayMode: 0 avec MP-SBPK-... et MP-SBSK-...
Numéro Succès (+243810000001) Simule un paiement Mobile Money approuvé en moins de 3 secondes.
Numéro Solde Faible (+243810000002) Simule un rejet pour provision insuffisante.
Numéro Annulation (+243810000003) Simule un refus de saisie de code PIN ou un timeout.
PLUGIN WORDPRESS

Extension MaishaPay pour WooCommerce

Connectez votre boutique WordPress en 5 minutes : téléversez l'extension maishapay-woocommerce.zip, renseignez vos clés API dans WooCommerce > Réglages > Paiements, puis cochez "Activer".

Le module gère automatiquement les conversions de devises (CDF, USD, XAF) et écoute les webhooks pour passer les commandes payées au statut « En cours de traitement » sans intervention humaine.

COLLECTE ET DÉCAISSEMENT

Collecte C2B & Transfert B2C Payouts

Collecte C2B (Customer to Business) : Déclenchez des invites Push USSD sur le téléphone de vos clients pour encaisser leurs portefeuilles Mobile Money.

Transfert B2C (Business to Customer) : Envoyez des paiements automatiques vers les portefeuilles mobiles de vos bénéficiaires (salaires, cagnottes, primes, remboursements) avec sécurité par liste blanche d'adresses IP.

TECHNICAL REFERENCE

Developer Documentation & REST API

Request specifications, JSON payload schemas, webhook handling, and comprehensive error code reference.

Open Interactive API Documentation (docs.maishapay.net)

1. Points d'accès (Endpoints) & Authentification

Toutes les requêtes adressées à l'API MaishaPay sont de type POST avec les en-têtes obligatoires :

Content-Type: application/json
Accept: application/json

Point d'accès universel :

https://marchand.maishapay.online/api/payment/rest/vers1.0/merchant
Le basculement entre Sandbox (Test) et Production (Live) s'effectue via le champ gatewayMode (0: Test, 1: Live) combiné à vos clés correspondantes.

2. Schéma de Requête Collecte C2B (Push USSD)

{
    "gatewayMode": 0, // 0 : SandBox, 1 : Live (Obligatoire)
    "publicApiKey": "MP-SBPK-xxxxxxxxxxxxxx", // Obligatoire
    "secretApiKey": "MP-SBSK-xxxxxxxxxxxxxx", // Obligatoire
    "transactionReference": "CMD-2026-9901", // Référence unique marchand (Obligatoire)
    "amount": 25.00, // Montant numérique (Obligatoire)
    "currency": "USD", // USD, CDF, XAF, EUR (Obligatoire)
    "chanel": "MOBILEMONEY", // Canal d'encaissement (Obligatoire)
    "provider": "MPESA", // MPESA, ORANGE, AIRTEL, AFRICEL, MTN (Obligatoire)
    "walletID": "+243810000001", // Numéro du portefeuille client (Obligatoire)
    "customerFullName": "Alain Mbuyi", // Facultatif
    "customerPhoneNumber": "+243810000001", // Facultatif
    "customerEmailAddress": "alain@example.com" // Facultatif
}

Réponse immédiate de l'API (Statut 202 Accepted)

{
    "headers": {},
    "original": {
        "status": 200,
        "data": {
            "originatingTransactionId": "CMD-2026-9901",
            "statusCode": "202",
            "statusDescription": "Accepted",
            "transactionId": "109842"
        }
    },
    "exception": null
}

3. Notification Webhook & Signature HMAC

Dès que le client saisit son code PIN secret, MaishaPay transmet une notification HTTP POST vers votre callbackUrl.

{
    "event": "payment.success",
    "transactionReference": "CMD-2026-9901",
    "transactionId": "109842",
    "amount": 25.00,
    "currency": "USD",
    "status": "COMPLETED",
    "paidAt": "2026-09-30 22:30:15"
}

Votre serveur doit systématiquement retourner un code HTTP 200 OK en moins de 5 secondes pour acquitter la réception du webhook.

4. Dictionnaire des Codes d'Erreurs & Solutions

Code HTTP Description Diagnostic & Résolution concrète
202 Accepted La demande Push USSD a été transmise à l'opérateur. En attente de saisie du PIN par le client.
400 Bad Request Paramètre obligatoire absent (ex: amount manquant ou négatif, walletID vide).
401 Unauthorized Clés API invalides ou divergence entre gatewayMode (0/1) et vos clés Sandbox/Live.
403 Forbidden Compte marchand non vérifié KYC, ou adresse IP non enregistrée dans la liste blanche (B2C).
404 Not Found URL d'endpoint erronée ou référence de transaction inexistante lors d'une vérification de statut.
422 Unprocessable Numéro de téléphone invalide (format international requis +243...) ou devise non admise.
500 Internal Server Error Timeout de l'opérateur télécom (> 30s) ou référence dupliquée. Vérifiez le statut avant de retenter.

5. Checklist avant le passage en Production (Live)

  • Avoir exécuté au moins une transaction concluante avec le numéro de test +243810000001.
  • Avoir complété le dossier d'agrément KYC de votre entreprise dans l'espace marchand.
  • Remplacer vos clés MP-SBPK-... et MP-SBSK-... par vos clés Live MP-LIVEPK-... et MP-LIVESK-....
  • Remplacer le paramètre "gatewayMode": 0 par "gatewayMode": 1 dans vos scripts de production.
  • Vérifier que votre callbackUrl est servi en HTTPS sécurisé avec certificat SSL valide.
NEED HUMAN SUPPORT?

Our merchant specialists and engineers are here for you

For complex integrations, B2C limit activations, or urgent account troubleshooting, our team is available 24/7.

Official WhatsApp Support: +242 05 078 94 31
WhatsApp : +242 05 078 94 31 Contact Form Browse FAQ