FAQ complète — Marchands, Développeurs & Clients

DiJiPay est une plateforme SaaS d'agrégation autonome de paiements. Elle permet aux marchands africains d'accepter des paiements Mobile Money (Orange Money, MTN MoMo, Airtel Money, Wave, M-Pesa, etc.) et des stablecoins (USDT, USDC) sur leur site web ou application, sans s'intégrer directement aux API des opérateurs.

DiJiPay fonctionne grâce à un système de relais Android (DijiAgentP) : une application installée sur le smartphone du marchand qui capture les SMS et notifications wallet de confirmation de paiement et les transmet sécurisément à DiJiPay pour validation.

DiJiPay supporte actuellement 54 pays africains avec 99 opérateurs configurés. Les pays principaux incluent :

• République du Congo (Airtel, MTN Congo, Paiement web)
• Cameroun (MTN MoMo, Orange Money)
• Côte d'Ivoire (Orange Money, MTN MoMo, Wave, Moov)
• Sénégal (Orange Money, Wave, Free Money)
• RDC (Airtel Money, Orange Money, M-Pesa)
• Et d'autres pays en expansion

En plus des Mobile Money, DiJiPay supporte les stablecoins (USDT, USDC) sur les réseaux TRC-20, BEP-20, ERC-20, Polygon, Solana — disponibles dans tous les pays.

Non. DiJiPay ne remplace pas votre compte. Vous gardez vos propres comptes d'encaissement chez les opérateurs (MTN, Orange, Airtel, etc.) ou votre wallet Binance/crypto.

DiJiPay vérifie que le paiement a bien eu lieu en utilisant les SMS de confirmation et les notifications wallet que vous recevez déjà naturellement. L'argent atterrit directement dans vos comptes — DiJiPay n'est pas un intermédiaire financier.

DiJiPay est un service SaaS facturé de deux façons :

• Crédits prépayés : 1 crédit = 1 transaction validée. Les packs commencent à 1 500 XAF pour 25 crédits.
• Abonnement mensuel : Transactions illimitées pendant la période. À partir de 2 500 XAF/mois.

DiJiPay ne prend aucune commission sur vos ventes. Vous gardez 100 % de ce que vos clients vous paient.

Non. DiJiPay est un logiciel de vérification et de réconciliation de paiements. Il ne détient pas de fonds, ne déplace pas d'argent et n'est pas un établissement de paiement. L'argent circule directement entre vos clients et vos comptes Mobile Money ou wallets.

DiJiPay est un outil technique qui automatise la vérification des preuves de paiement, comme un comptable automatisé qui confirme que vous avez bien reçu un virement en lisant votre relevé bancaire.

1. Cliquez sur "Créer un compte" sur la page d'accueil.
2. Renseignez votre nom, email professionnel, numéro de téléphone et pays d'opération.
3. Choisissez un mot de passe sécurisé (ou connectez-vous avec Google/Apple).
4. Vérifiez votre adresse email en cliquant sur le lien envoyé par DiJiPay.
5. Votre compte est activé — vous recevez automatiquement 25 crédits gratuits (niveau Pro).

À l'ouverture de votre compte, DiJiPay vous offre 25 crédits gratuits de niveau Pro. Ces crédits vous permettent de tester toutes les fonctionnalités de DiJiPay sans restriction — Mobile Money et wallets crypto.

Une fois ces 25 crédits utilisés, vous choisissez librement :

• Abonnement Standard (2 500 XAF/mois) — Mobile Money uniquement, 1 canal
• Abonnement Pro (5 000 XAF/mois) — Mobile Money + wallets crypto, 5 canaux
• Pack de crédits Standard ou Pro selon vos besoins

Oui. DiJiPay supporte la connexion OAuth 2.0 avec Google et Sign in with Apple. Lors de la première connexion OAuth, un compte Marchand est créé automatiquement avec l'email de votre compte Google ou Apple.

Vous pouvez ensuite définir un mot de passe pour permettre la connexion par email/mot de passe en complément.

Depuis la page de connexion, cliquez sur "Mot de passe oublié", entrez votre email et suivez les instructions envoyées par email. Le lien de réinitialisation est valide 24 heures.

Pour supprimer votre compte, contactez support@dijigestion.tech avec votre email de compte et votre demande de clôture. La suppression entraîne :

• Désactivation immédiate de l'accès
• Révocation de toutes les clés API et terminaux relais
• Conservation des données de transaction et de facturation pendant les délais légaux (5 à 10 ans selon le type)

Les offres Enterprise sont destinées aux structures avec plusieurs points de vente ou un fort volume de transactions. Toutes incluent les wallets crypto.

Pour plus de 30 canaux, contactez support@dijigestion.tech.

Oui ! DiJiPay propose des remises sur les engagements longue durée :

• Mensuel : Tarif standard — 0 % de remise
• Trimestriel (3 mois) : −5 % — soit environ 1 semaine offerte
• Semestriel (6 mois) : −10 % — soit ~3 semaines offertes
• Annuel (12 mois) : −20 % — soit 2,4 mois offerts

Rendez-vous dans Dashboard → Facturation et sélectionnez le plan souhaité. Le changement prend effet dès la confirmation du paiement via DiJiPay.

En cas de downgrade (passer de Pro à Standard), le nouveau plan prend effet à la fin de la période en cours.

Les crédits DiJiPay sont une alternative aux abonnements : 1 crédit = 1 transaction validée. Vous ne payez que ce que vous utilisez, sans engagement mensuel.

• Les crédits sont débités uniquement quand une transaction passe en statut SUCCESS.
• Les transactions FAILED ou EXPIRED ne consomment pas de crédit.
• Les crédits n'expirent pas.

Les packs de crédits ont deux niveaux :

• Standard Pack Découverte (25 crédits — 1 500 XAF) et Pack Boutique (60 crédits — 3 000 XAF) : accès Mobile Money uniquement.
• Pro Pack Commerce Pro (150 crédits — 6 000 XAF) et Pack Grossiste Pro (400 crédits — 12 000 XAF) : accès Mobile Money et wallets crypto débloqués.

Quand votre solde atteint 0 et que vous n'avez pas d'abonnement actif :

• DiJiPay vous envoie un email d'alerte.
• Toutes nouvelles transactions sont bloquées sur votre site.
• Les transactions déjà créées et en cours (AWAITING_PAYMENT) continuent jusqu'à leur expiration ou validation.

Pour réactiver immédiatement : rechargez un pack de crédits ou souscrivez un abonnement depuis Dashboard → Facturation.

DiJiPay envoie automatiquement un email d'alerte quand votre solde de crédits tombe à 5 crédits ou moins. Un rappel est envoyé maximum 1 fois par 24 heures pour ne pas vous surcharger d'emails.

Non. Tant que votre abonnement est actif, vos transactions sont déjà incluses sans frais supplémentaires. L'achat de packs de crédits n'est disponible qu'une fois l'abonnement expiré.

Cette règle protège contre les achats inutiles : votre abonnement couvre tout.

DiJiPay supporte tous les opérateurs configurés dans son catalogue — actuellement 99 opérateurs. Les principales intégrations incluent MTN MoMo, Orange Money, Airtel Money, Wave, M-Pesa, Free Money, Moov Money et d'autres.

L'opérateur doit être disponible dans votre pays et un SMS de confirmation doit être envoyé lors de chaque transaction pour que DiJiPay puisse automatiquement réconcilier le paiement.

1. Allez dans Dashboard → Relais et jumelez d'abord un terminal Android (DijiAgentP).
2. Depuis le même écran, créez un canal en sélectionnant l'opérateur et en renseignant le numéro Mobile Money d'encaissement.
3. Le canal est associé à votre terminal relais. Quand un client paie, le SMS de confirmation arrive sur le terminal et DiJiPay le capte automatiquement.

Le nombre de canaux actifs dépend de votre plan :

• Standard : 1 canal
• Pro : 5 canaux (multi-numéros, multi-opérateurs)
• Enterprise : 10 à 30 canaux selon l'offre

Chaque canal correspond à un numéro d'encaissement distinct, potentiellement chez des opérateurs différents.

Vérifiez dans l'ordre :

1. Terminal relais en ligne : DijiAgentP doit être actif, connecté à Internet et affiché ONLINE dans Dashboard → Relais.
2. SMS reçu : Le SMS de confirmation de l'opérateur doit avoir été reçu sur le téléphone relais.
3. Règle de parsing active : Le format du SMS doit correspondre à une règle de parsing dans le catalogue DiJiPay. Certains opérateurs modifient leurs formats SMS — contactez le support si le problème persiste.
4. Montant et devise corrects : Le montant payé doit correspondre exactement au montant de la transaction.
5. Transaction non expirée : Les transactions expirent après 30 minutes par défaut. Le client doit payer avant l'expiration.

DiJiPay supporte les stablecoins USDT et USDC sur les réseaux suivants :

• TRC-20 (Tron) — réseau le plus utilisé en Afrique pour les faibles frais
• BEP-20 (BNB Chain)
• ERC-20 (Ethereum)
• Polygon (MATIC)
• Solana (SOL)
• Bitcoin (BTC)

1. Le marchand crée une transaction DiJiPay — DiJiPay génère un code de référence unique DJP-XXXXXXXX.
2. Le client voit le montant en USDT/USDC, l'adresse wallet du marchand et le code DJP-XXXXXXXX dans le widget.
3. Le client effectue le virement depuis Binance Pay ou son wallet, en ajoutant DJP-XXXXXXXX dans le champ "Note / Remarque".
4. DijiAgentP capte la notification Binance/wallet sur le téléphone relais.
5. DiJiPay vérifie la notification, identifie le code DJP, et valide la transaction.

Non. Les wallets crypto sont disponibles pour :

• Les 25 crédits d'essai gratuits à l'ouverture du compte (accès Pro complet)
• L'abonnement Pro et tous les plans Enterprise
• Les packs de crédits Pro (Pack Commerce Pro 150 crédits et Pack Grossiste Pro 400 crédits)

L'abonnement Standard et les packs Standard donnent accès aux canaux Mobile Money uniquement.

Quand le montant de la transaction est en devise locale (ex. 30 000 XAF), DiJiPay effectue automatiquement la conversion au taux de marché live en USDT ou USDC selon le canal sélectionné. Le taux appliqué est archivé dans les métadonnées de la transaction pour l'audit.

Le montant affiché au client dans le widget est en stablecoin, arrondi à 2 décimales (ex. 21,99 USDT).

Il y a deux modes d'intégration :

1. Redirection (recommandé) — Votre serveur crée une transaction via l'API DiJiPay et redirige le client vers l'URL de paiement https://votre-domaine/pay/{client_token}/.

2. iFrame / widget flottant — Intégrez la page de paiement dans une iframe sur votre site. Le widget reste visible et flottant pendant toute la navigation.

Dans les deux cas, DiJiPay envoie un webhook à votre serveur dès que la transaction est validée.

Oui. Le widget DiJiPay est entièrement responsive. Il s'adapte automatiquement aux petits écrans mobiles. L'expérience de paiement est optimisée pour les smartphones, qui représentent la majorité des utilisateurs Mobile Money en Afrique.

Par conception, DiJiPay n'affiche pas automatiquement le nom de votre entreprise sur la page de paiement. Cela protège votre confidentialité opérationnelle. Vous pouvez inclure des informations dans les métadonnées de la transaction si vous souhaitez les afficher.

La durée de validité d'une transaction est de 30 minutes par défaut. Passé ce délai, la transaction expire et le client ne peut plus la payer. Votre site reçoit un webhook payment.expired.

Vous pouvez créer une nouvelle transaction si le client souhaite recommencer.

Oui. Une fois le paiement validé, le widget affiche une confirmation de succès et redirige automatiquement le client vers votre site. L'URL de redirection peut être configurée dans les paramètres de la transaction ou par défaut vers la page d'origine.

En parallèle, votre serveur reçoit le webhook payment.success avec toutes les données de la transaction validée.

L'API DiJiPay utilise une authentification HMAC-SHA256. Chaque requête doit inclure :

• X-Dijipay-Key : Votre clé API (pk_xxxxxxxx)
• X-Dijipay-Timestamp : Timestamp Unix en secondes
• X-Dijipay-Nonce : Identifiant unique de requête (UUID recommandé)
• X-Dijipay-Signature : Signature HMAC-SHA256 calculée sur la chaîne canonique

La chaîne canonique à signer est : METHOD\nPATH\nTIMESTAMP\nNONCE\nSHA256(body)

Endpoint : POST /api/v1/payments/initiate/

Corps JSON minimal :

{
  "merchant_order_id": "CMD-2026-001",
  "amount": "15000",
  "currency": "XAF",
  "channel_id": "votre-uuid-canal",
  "customer_msisdn": "24206XXXXXXX"
}

La réponse inclut le client_token permettant de construire l'URL de paiement : /pay/{client_token}/.

Endpoint : GET /api/v1/payments/{merchant_order_id}/

Retourne le statut courant et les métadonnées de la transaction. Les statuts possibles sont :

• INITIATED : Transaction créée, paiement non encore lancé
• AWAITING_PAYMENT : En attente de paiement du client
• AWAITING_VALIDATION : Preuve reçue, vérification en cours
• SUCCESS : Paiement validé et confirmé
• FAILED : Paiement échoué ou rejeté
• EXPIRED : Délai dépassé
• DISPUTED : En litige

Endpoint : GET /api/v1/channels/

Retourne la liste de vos canaux actifs avec leurs identifiants, opérateurs et statuts. Utilisez l'id d'un canal lors de la création de transaction.

DijiAgentP est l'application Android développée par Diji Gestion qui transforme un smartphone en terminal relais DiJiPay. Elle capture automatiquement les SMS de confirmation Mobile Money et les notifications wallet, puis les transmet sécurisément au serveur DiJiPay.

Téléchargement depuis votre portail marchand : Dashboard → Relais → Télécharger DijiAgentP.

1. Dans Dashboard → Relais, cliquez "Nouveau terminal" et générez un QR code de jumelage.
2. Ouvrez DijiAgentP sur votre smartphone Android.
3. Scannez le QR code pour initier le jumelage.
4. Une fois jumelé (statut PAIRED), le terminal apparaît ONLINE dans votre dashboard.
5. Créez ensuite un canal Mobile Money associé à ce terminal.

Un terminal passe OFFLINE si DijiAgentP n'envoie pas de heartbeat depuis plus de 90 secondes. Vérifiez :

• Le téléphone relais est allumé et a accès à Internet (WiFi ou données mobiles).
• DijiAgentP est en cours d'exécution (service foreground actif).
• DijiAgentP n'a pas été forcé à s'arrêter par le système Android (désactivez l'optimisation de batterie pour DijiAgentP).
• La connexion Internet du téléphone relais est stable.

• Ne jamais exposer votre secret HMAC côté client (JavaScript dans le navigateur). Les appels API signés doivent toujours venir de votre serveur backend.
• Utiliser des variables d'environnement pour stocker vos clés — jamais dans le code source.
• Rotation des clés : En cas de compromission suspectée, faites une rotation depuis Dashboard → Intégration → Rotation du secret.
• Restreindre les IP : Si possible, configurez votre serveur pour n'accepter les appels DiJiPay que depuis vos IPs de production.

Chaque webhook DiJiPay est signé avec votre webhook_secret (HMAC-SHA256). Sur votre serveur, recalculez la signature et comparez-la à l'en-tête X-Dijipay-Signature. Rejetez toute requête dont la signature ne correspond pas.

import hmac, hashlib
expected = hmac.new(webhook_secret.encode(), body, hashlib.sha256).hexdigest()
if not hmac.compare_digest(expected, received_sig):
    return 403  # Rejeter

DiJiPay implémente plusieurs couches de protection :

• Authentification RSA-PSS du terminal relais (clé dans Android Keystore)
• Score de confiance des applications wallet Android (package, certificat, séquence)
• Signature d'intégrité HMAC-SHA256 sur chaque transaction à la création
• Statuts terminaux : une transaction SUCCESS ne peut pas être re-validée
• Anti-rejeu : nonces à usage unique, TTL 600s
• Correspondance stricte : montant, canal, référence, devise, fenêtre temporelle

Le moteur de réconciliation DiJiPay fonctionne en deux directions :

1. Preuve → Transaction (push) : Quand un SMS ou une notification wallet arrive, DiJiPay cherche la transaction correspondante en comparant le montant, la référence, le canal et la fenêtre temporelle. Si une correspondance unique est trouvée, la transaction passe en SUCCESS.
2. Transaction → Preuve (pull) : Toutes les 30 secondes, DiJiPay revérifie les transactions AWAITING_VALIDATION pour trouver une preuve correspondante qui aurait pu être manquée.

Ce double mécanisme garantit qu'aucun paiement réel n'est perdu, même en cas de léger décalage réseau.

Une transaction peut rester en AWAITING_VALIDATION si :

• Le terminal relais était temporairement hors ligne quand le SMS est arrivé
• Le format du SMS n'a pas été parsé correctement
• La référence soumise par le client ne correspond pas exactement

Actions possibles :

1. Vérifiez l'historique des SMS dans le portail (Dashboard → Transactions → détail).
2. Si le terminal est de nouveau en ligne, le sweep automatique (toutes les 30s) devrait réconcilier automatiquement.
3. Contactez le support avec l'ID de transaction si le problème persiste après 5 minutes.

• Vérifiez que l'URL webhook configurée dans Dashboard → Intégration est publiquement accessible depuis Internet (pas localhost).
• Votre serveur doit répondre avec un code HTTP 2xx dans les 10 secondes. Sinon, DiJiPay retente la livraison jusqu'à 3 fois.
• Consultez l'historique des livraisons dans Dashboard → Intégration → Webhooks pour voir les erreurs.

1. J-5 à J-1 : DiJiPay vous envoie un email d'alerte chaque jour pour vous rappeler l'expiration imminente.
2. À la date d'expiration : L'abonnement passe en grace period (48 heures supplémentaires).
3. Après la grace period : L'abonnement est suspendu. Toutes les nouvelles transactions sont bloquées sur votre site.

Pour éviter toute interruption : renouvelez votre abonnement depuis Dashboard → Facturation avant l'expiration.

Rendez-vous dans Dashboard → Facturation, sélectionnez votre plan et durée, puis procédez au paiement via DiJiPay. L'abonnement est renouvelé dès la confirmation du paiement — le nouveau cycle démarre immédiatement.

Oui, vous pouvez passer à un plan supérieur à tout moment. Le nouveau plan prend effet immédiatement dès la confirmation du paiement. La montée en gamme (upgrade) est proactive.

Pour un downgrade (passage à un plan inférieur), le changement prend effet au prochain cycle de renouvellement.

1. Demandez au client la preuve de paiement (capture d'écran du SMS ou confirmation de l'app Mobile Money).
2. Vérifiez dans Dashboard → Transactions si une transaction correspondante existe (même montant, même heure).
3. Vérifiez dans Dashboard → Relais si le SMS de confirmation a bien été reçu (logs de réception).
4. Si tout est cohérent mais la réconciliation n'a pas eu lieu, contactez le support avec l'ID de transaction et la capture d'écran du client.

Les remboursements sont de la responsabilité du marchand. DiJiPay n'effectue pas de remboursements automatiques car il n'est pas intermédiaire financier — l'argent est directement dans votre compte Mobile Money ou wallet.

Pour rembourser un client, vous effectuez vous-même un virement depuis votre compte Mobile Money/wallet vers le compte du client.

• ID de transaction DiJiPay (format UUID ou référence DJP-XXXXXXXX)
• Date et heure approximatives de l'incident
• Description du problème avec captures d'écran si possible
• Statut actuel de la transaction (AWAITING_PAYMENT, AWAITING_VALIDATION, etc.)
• Plan actif (Standard, Pro, Enterprise)

Plus vous fournissez d'informations, plus vite le support peut résoudre votre problème.