Outils de développement

Bienvenue dans la documentation de l’API du service MeSomb.

MeSomb propose un ensemble de services financiers que vous pouvez intégrer facilement à votre système :

  • Paiement mobile: vous pouvez intégrer le paiement mobile numérique à votre activité en ligne en utilisant nos API.
  • Portefeuille numérique: nous fournissons une solution clé en main de gestion de portefeuille numérique.
  • Collecte de fonds: bientôt disponible

Exemple de code et bibliothèques

Client du langage de programmation

Cette section présente les bibliothèques clientes permettant d’accélérer votre développement dans différents langages. Si le langage dont vous avez besoin est absent, ouvrir un ticket ici

LangueDépôt
PHPhttps://github.com/hachther/mesomb-php
JavaScripthttps://github.com/hachther/mesomb-js-client
Pythonhttps://github.com/hachther/mesomb-python-client
Javahttps://github.com/hachther/mesomb-java-client

Clients du framework

Il existe quelques clients pour les intégrer directement dans différents frameworks existant sur le marché. Si vous trouvez votre bonheur ci-dessous, profitez-en, nous terminerons les travaux en cours.

FrameworkLien
WooCommercehttps://wordpress.org/plugins/mesomb-for-woocommerce
Laravelhttps://github.com/hachther/laravel-mesomb
PDV Odoohttps://apps.odoo.com/apps/modules/14.0/pos_mesomb/

Fonctionnalités d’intégration

Webhooks

Si vous souhaitez être notifié à chaque fois que vous recevez un paiement sur MeSomb, le webhook est la solution qu’il vous faut. Vous pouvez configurer un webhook pour chaque service enregistré, et pour cela, vous devez définir l’URL complète vers laquelle envoyer les données à chaque fois qu’un paiement est effectué.

Suivez ce tutoriel pour apprendre à configurer un webhook.

Une HTTP POST sera envoyée à l’URL de votre webhook. Les données transmises correspondent au résultat de opération Collect Money.

Consultez le guide de livraison et de reprise pour connaître les limites de relance, les règles de désactivation automatique et la procédure de réactivation.

Livraison et reprise

Acceptez les paiements sur votre application MeSomb depuis ORANGE et MTN Pour l’application en mode développement, vous pouvez utiliser les numéros suivants

  • 237400001019 et 237400001020 pour les transactions réussies
  • 237400001021 pour les transactions échouées

Ouvrez le lien ci-dessous pour consulter des exemples de code : https://github.com/hachther/mesomb-snippet/

Liste des codes d'erreur :

CodeDescription
subscriber-insufficient-balancesolde insuffisant du compte
subscriber-not-foundCe compte n'existe pas
subscriber-internal-errorProblème lors du traitement. Il peut s’agir d’un solde insuffisant, d’un délai d’attente dépassé, d’un code secret incorrect...
generic-errorErreur lors du traitement de la transaction
subscriber-limit-reachedCe compte a atteint sa limite
provider-application-problemProblème avec le fournisseur de services
provider-second-number-not-foundLe deuxième numéro de ce compte n’est pas un numéro de fournisseur valide
unknown-issueProblème inconnu
subscriber-invalid-lengthLe numéro de téléphone de ce compte est invalide
subscriber-invalid-min-amountLe montant est inférieur au montant minimum autorisé
subscriber-withdrawal-failedEn cas d’échec lors du retrait d’argent
subscriber-timeoutDélai d’opération dépassé
subscriber-invalid-secret-codeCode secret invalide
subscriber-invalid-max-amountLe montant de la transaction dépasse le maximum autorisé
invalid-amountLe montant de la transaction est invalide