Frequently Asked Questions MaishaPay

La création d’un compte marchand MaishaPay s’effectue en quelques minutes sur notre portail marchand.maishapay.online. Cliquez sur « Ouvrir un compte », renseignez les informations de votre entreprise (dénomination sociale, pays, numéro de téléphone et adresse email). Vous accédez immédiatement à l’environnement de test (Sandbox) pour explorer le tableau de bord et débuter vos intégrations techniques.

Pour activer votre compte en production (mode Live) et recevoir vos reversements, notre service de conformité requiert les pièces suivantes :

• Copie valide de la pièce d’identité du gérant ou mandataire légal (Passeport, Carte d’électeur ou Permis de conduire).
• Registre de Commerce et du Crédit Mobilier (RCCM).
• Numéro d’Identification Nationale (Id. Nat) ou Numéro d’Impôt (NIF).
• Justificatif de domicile de l’entreprise ou contrat de bail commercial.
• Relevé d’Identité Bancaire (RIB) pour vos règlements.

MaishaPay prend en charge plusieurs devises locales et internationales au sein d’un compte multi-devises unique : le Franc Congolais (CDF), le Dollar Américain (USD), le Franc CFA d’Afrique Centrale et de l’Ouest (XAF / XOF), l’Euro (EUR), ainsi que les principaux stablecoins numériques (USDT, USDC).

Nous appliquons des standards bancaires de pointe. Pour renforcer la sécurité de votre compte, activez l’authentification à deux facteurs (2FA) dans les paramètres du portail, ne partagez jamais vos clés secrètes d’API (Secret API Key), configurez la liste blanche d’adresses IP (IP Whitelisting) pour vos appels serveurs et créez des accès collaborateurs avec des rôles et permissions restreints.

MaishaPay fédère l’ensemble des canaux de paiement majeurs en Afrique et à l’international :

• Mobile Money : Vodacom M-Pesa, Orange Money, Airtel Money, MTN Mobile Money, Africell Money.
• Cartes bancaires : Visa, Mastercard (débit, crédit, prépayées et virtuelles).
• Paiement par QR Code dynamique : flash instantané depuis les applications bancaires et portefeuilles mobiles.
• Paiement par USSD : encaissement sans Internet requis via menus interactifs sur téléphone.
• Crypto & Web3 : USDT (TRC-20, ERC-20), USDC, Bitcoin.

Toutes les transactions effectuées via Mobile Money, cartes bancaires ou QR Code sont confirmées et créditées instantanément en temps réel sur votre solde marchand MaishaPay. Vous et votre client recevez une notification immédiate par SMS, email ou webhook.

Depuis l’onglet « Virements & Retraits » de votre tableau de bord, vous pouvez programmer des virements automatiques quotidiens ou initier un virement ponctuel vers votre compte bancaire professionnel ou vers votre portefeuille Mobile Money. Les virements bancaires locaux sont exécutés sous 24h ouvrées.

Le terminal MaishaPay Smart POS est un appareil électronique autonome doté d’un écran tactile haute définition, d’un lecteur de cartes bancaires (à puce EMV, bande magnétique et sans contact NFC), d’une caméra pour scanner les QR Codes et d’une imprimante thermique haute vitesse intégrée. Il dispose d’une double connectivité 4G LTE et Wi-Fi pour encaisser partout.

La commande de terminaux de paiement physiques MaishaPay est disponible en République Démocratique du Congo (RDC) et en République du Congo (Congo-Brazzaville). Pour les autres pays, notre solution M-Terminal Virtual sur smartphone est utilisable immédiatement.

Rendez-vous sur notre page Commander un terminal. Remplissez le formulaire en indiquant le nom de votre établissement, votre adresse exacte, votre secteur d’activité et votre numéro WhatsApp. La livraison s’effectue sous 24 à 48 heures ouvrées à Kinshasa, Lubumbashi, Goma, Brazzaville et Pointe-Noire, avec configuration et formation offertes par nos techniciens.

Le MaishaPay M-Terminal Virtual est un terminal de paiement virtuel qui permet aux commerçants d’encaisser facilement les paiements de leurs clients sans avoir besoin d’un appareil POS dédié. Votre simple smartphone Android devient un terminal d’encaissement complet sans caution ni achat de matériel.

Grâce au QR Code, à l’USSD et au NFC, les commerçants peuvent accepter les paiements directement depuis un smartphone : affichage d’un QR Code dynamique à scanner, envoi d’un ordre USSD vers le téléphone du client, ou paiement sans contact par simple approche d’une carte bancaire NFC au dos de votre smartphone.

Oui ! Avec le paiement USSD, une connexion Internet n’est pas obligatoirement nécessaire : un simple téléphone suffit pour encaisser les paiements des clients. L’ordre de paiement transite par le réseau GSM de l’opérateur télécom et le client valide son paiement avec son code PIN secret.

L’application officielle est disponible en téléchargement gratuit sur le Google Play Store sous le nom « MaishaPay Terminal » (identifiant de paquet : com.maishapay.terminal). Connectez-vous avec vos identifiants marchands MaishaPay pour commencer à encaisser instantanément.

Connectez-vous à votre espace marchand, cliquez sur « Liens de paiement » puis « Créer un lien ». Renseignez le libellé de l’article ou de la prestation, le montant, la devise souhaitée (USD, CDF, etc.) et une éventuelle date d’expiration. Cliquez sur « Générer » : votre lien sécurisé est prêt en 30 secondes.

Vous pouvez copier le lien et le coller directement dans une conversation WhatsApp, un SMS, un e-mail, ou l’intégrer sous forme de bouton ou de QR Code sur vos réseaux sociaux (Instagram, Facebook, TikTok). Le client clique dessus depuis n’importe quel navigateur sans installer d’application.

Oui. Lors de la création du lien, activez l’option « Montant personnalisable par le client ». Vous pouvez définir un montant minimum ou suggéré, laissant le client libre de renseigner le montant de son choix.

MaishaPay Checkout est une solution d’encaissement prête à l’emploi conçue pour les sites e-commerce et applications mobiles. Elle affiche une interface optimisée pour le taux de conversion avec toutes les méthodes de paiement locales et internationales, dans la langue du client, avec détection automatique de l’opérateur.

En mode Redirection, votre client est redirigé vers une page sécurisée hébergée par MaishaPay, puis renvoyé sur votre boutique une fois le paiement conclu. En mode Modal (Popin), le module de paiement s’ouvre directement en surimpression au-dessus de votre panier d’achat, maintenant le client en immersion sur votre site web sans rupture visuelle.

Pour initier une session Checkout, envoyez en POST : gatewayMode (0: Test, 1: Live), publicApiKey, secretApiKey, transactionReference (identifiant unique de commande), amount (montant), currency (USD, CDF, etc.), ainsi que vos URLs de retour (successUrl, cancelUrl, callbackUrl).

La passerelle de paiement (Payment Gateway) MaishaPay est une infrastructure robuste d’API REST serveur à serveur. Elle permet aux grandes entreprises, banques, fintechs et plateformes SaaS d’intégrer l’encaissement et le décaissement de manière totalement transparente et marque blanche dans leurs propres systèmes métier.

Notre infrastructure utilise un routage dynamique multi-opérateurs. Si un réseau télécom subit une latence ou une panne temporaire, notre moteur de basculement réachemine intelligemment les flux et propose des alternatives instantanées pour garantir un taux de succès maximal.

MaishaPay accepte les stablecoins adossés au dollar américain : USDT (sur réseaux TRON TRC-20 et Ethereum ERC-20), USDC, ainsi que le Bitcoin (BTC).

Absolument. Vous pouvez paramétrer votre compte pour convertir instantanément les cryptomonnaies reçues en devises fiduciaires (USD, Franc Congolais CDF, Franc CFA XAF) au taux du marché lors de la confirmation blockchain, vous protégeant ainsi contre toute volatilité.

Le programme MaishaPay Startups offre un accès anticipé gratuit et illimité à nos environnements de bac à sable (Sandbox), des frais de transaction réduits sur les 6 premiers mois, un accompagnement technique personnalisé par nos architectes de solutions et un canal de support direct (Slack ou WhatsApp) avec nos ingénieurs.

Pour postuler, vous devez être une jeune entreprise technologique immatriculée depuis moins de 3 ans, développer une application web ou mobile innovante et prévoir de lancer vos flux de paiements en Afrique. Rendez-vous sur la page Startups pour déposer votre dossier.

MaishaPay for WhatsApp transforme l’application de messagerie la plus populaire en canal de vente conversationnel. Vous pouvez créer des liens de paiement en un clin d’œil et les envoyer à vos clients dans le fil de discussion, ou connecter un chatbot via notre API pour automatiser la commande et le paiement direct.

Oui. Dès que la transaction est validée par l’opérateur ou la banque, une confirmation instantanée avec le numéro de référence, le montant et le reçu électronique téléchargeable est envoyée directement au numéro WhatsApp du client.

Connectez-vous sur votre compte marchand à l’adresse marchand.maishapay.online, rendez-vous dans le menu « Développeur » puis « Clés API ». Vous y trouverez vos clés de test commençant par MP-SBPK- (Clé publique) et MP-SBSK- (Clé secrète).

En mode Sandbox (gatewayMode: 0), utilisez les identifiants de test suivants :

• +243810000001 : simule un paiement Mobile Money validé avec succès (statut 202 puis confirmation).
• +243810000002 : simule un refus pour solde insuffisant.
• +243810000003 : simule une annulation par l’utilisateur ou un timeout opérateur.
• Pour les cartes Visa/Mastercard : utilisez les numéros 4242 4242 4242 4242 avec n’importe quelle date d’expiration future et code CVC 123.

Pour activer vos transactions réelles :

1. Validez au moins une transaction concluante en Sandbox.
2. Finalisez la vérification KYC de votre compte marchand.
3. Remplacez vos clés de test par vos clés Live (MP-LIVEPK- et MP-LIVESK-).
4. Changez le paramètre gatewayMode de 0 à 1 dans vos requêtes API.

Depuis votre tableau de bord WordPress, allez dans « Extensions » > « Ajouter », téléversez l’archive ZIP du plugin officiel MaishaPay WooCommerce, puis cliquez sur « Activer l’extension ». Vous pouvez également retrouver le guide complet dans notre section Développeurs.

Allez dans WooCommerce > Réglages > onglet « Paiements » > cliquez sur « Gérer » à côté de MaishaPay. Cochez « Activer », sélectionnez le mode (Sandbox pour tester, Live pour vendre), collez votre Clé publique et votre Clé secrète, puis cliquez sur « Enregistrer les modifications ».

Oui. Lorsque le client effectue son paiement, le webhook de MaishaPay notifie en toute sécurité votre site WordPress. La commande passe automatiquement du statut « En attente de paiement » à « En cours de traitement » (ou « Terminé » pour les produits virtuels/téléchargeables), sans intervention manuelle.

La collecte C2B permet d’initier une demande de débit direct sur le portefeuille Mobile Money d’un client. Votre serveur envoie une requête POST JSON vers notre endpoint avec le numéro du client (walletID), le fournisseur (provider: MPESA, ORANGE, AIRTEL, etc.), le montant et la devise. Notre plateforme sollicite instantanément l’opérateur télécom pour envoyer une invite Push USSD sur le téléphone du client, qui saisit son code secret pour valider.

L’adresse officielle de l’endpoint REST pour la collecte C2B est :
https://marchand.maishapay.online/api/payment/rest/vers1.0/merchant
Toutes les requêtes doivent être de type POST avec un en-tête Content-Type: application/json.

Lors de votre appel initial, l’API retourne un code de statut 202 Accepted confirmant que l’invite USSD a été envoyée sur le terminal client. Lorsque le client tape son code PIN, MaishaPay envoie une notification Webhook POST à votre callbackUrl avec le statut final (200 OK et référence de transaction). Vous pouvez également interroger l’état de la transaction via notre endpoint de vérification de statut.

L’API B2C (Business to Customer) permet d’envoyer des fonds directement depuis votre solde marchand vers le compte Mobile Money ou bancaire d’un destinataire. Cette solution est idéale pour le versement automatique de salaires, le paiement de commissions d’agents, les cagnottes ou le remboursement de clients.

Étant donné le mouvement direct de fonds sortants, l’accès à l’API B2C nécessite l’activation préalable de l’option auprès de votre chargé de compte, la configuration d’adresses IP fixes autorisées (IP Whitelisting) sur votre compte marchand, et l’utilisation de votre clé d’API secrète chiffrée.

Toutes les API de MaishaPay utilisent le format standard JSON avec encodage UTF-8. Les en-têtes doivent inclure Content-Type: application/json et Accept: application/json. Les réponses retournent un objet JSON structuré avec code de statut HTTP et données de transaction.

Chaque événement webhook transmis par MaishaPay inclut un en-tête sécurisé X-MaishaPay-Signature contenant le hachage HMAC-SHA256 du corps de la requête calculé avec votre clé secrète. Votre serveur doit recalculer ce hachage pour valider formellement l’authenticité du message avant de délivrer le service.

Votre serveur doit obligatoirement retourner un code HTTP 200 OK avec un corps JSON ou texte simple (ex: {"received": true}) sous un délai maximal de 5 secondes. En l’absence de réponse 200, MaishaPay effectue des réessais automatiques avec intervalle exponentiel.

Oui. L’ensemble des systèmes de traitement de cartes bancaires et données transactionnelles de MaishaPay est certifié PCI-DSS (Payment Card Industry Data Security Standard). Les numéros complets de cartes sont tokenisés de bout en bout et ne sont jamais stockés sur nos serveurs marchands.

Vos fonds sont cantonnés sur des comptes séquestres dédiés auprès d’établissements bancaires agréés par la Banque Centrale. Toutes les communications réseau sont chiffrées en TLS 1.3 avec clés de 256 bits, et notre moteur anti-fraude analyse chaque paiement en temps réel pour bloquer les tentatives suspectes.

MaishaPay applique une tarification transparente au succès (Pay-as-you-go). Il n’y a aucun frais d’installation, aucun abonnement mensuel obligatoire et aucun frais de tenue de compte. Une commission compétitive est prélevée uniquement sur les transactions conclues avec succès. Retrouvez le détail complet sur notre page Grille Tarifaire.

Non, absolument aucun frais. Si un paiement est annulé par le client, si le solde est insuffisant ou si l’opération échoue pour cause de réseau, aucun centime n’est prélevé. Vous ne payez que pour les transactions que vous encaissez réellement.

Depuis votre tableau de bord marchand, accédez à la section « Transactions ». Vous disposez d’outils de recherche avancée par date, montant, statut, numéro de référence ou moyen de paiement. Vous pouvez exporter vos rapports comptables aux formats CSV, Excel et PDF en un clic.

Pour rembourser un client, rendez-vous dans le détail de la transaction concernée sur votre portail marchand et cliquez sur « Émettre un remboursement ». Vous pouvez effectuer un remboursement intégral ou partiel. Vous pouvez également déclencher un remboursement programmatique via l’API REST de remboursement.

Notre équipe d’assistance est disponible 24h/24 et 7j/7 :

• Support WhatsApp direct : disponible pour les urgences marchandes au +242 05 078 94 31.
• Email d’assistance : support@maishapay.online.
• Agent IA MaishaPay : disponible en direct sur notre page Aide & Support pour répondre instantanément à vos questions techniques et d’intégration.
• Formulaire de contact : disponible sur notre page Contact.

Le délai moyen de réponse est de moins de 15 minutes pour le support WhatsApp et de moins de 2 heures ouvrées pour les demandes transmises par email ou via le système de tickets.