Developer tools

Welcome to MeSomb service API documentation.

MeSomb provides a group of financial services that you can easily integrate into your system:

  • Mobile Payment: you can integrate digital mobile payment into your online business by using our APIs.
  • Digital Wallet: We provide a turnkey digital wallet system management.
  • Fundraising: coming soon

Code Sample and Libraries

Programming language client

In this section, you will have clients to speed up your development in different languages. If a language is missing and you need it just open a ticket here

LanguageRepository
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

Framework clients

There are some clients to integrate them directly into different frameworks existing on the market. If your find your happiness below, enjoy we will complete ongoing.

FrameworkLink
WooCommercehttps://wordpress.org/plugins/mesomb-for-woocommerce
Laravelhttps://github.com/hachther/laravel-mesomb
Odoo POShttps://apps.odoo.com/apps/modules/14.0/pos_mesomb/

Integration Features

Webhooks

If you want to be notified each time you receive a payment on MeSomb, webhook is the solution for you. You can set up a webhook for each registered service, and for that, you must set up the full URL where to push data each time a payment is performed.

Follow this tutorial to see how to set up a webhook.

An HTTP POST request will be sent to your webhook link. Data sent are the same as the result of Collect Money operation.

See the delivery and recovery guide for retry limits, automatic disabling rules and reactivation instructions.

Delivery and recovery

Accept payment on your MeSomb app from ORANGE and MTN For app in development mode you can use the following numbers

  • 237400001019 and 237400001020 for success transactions
  • 237400001021 for failed transactions

Open the below link to see some code snippet: https://github.com/hachther/mesomb-snippet/

List of error codes:

CodeDescription
subscriber-insufficient-balanceinsufficient balance in the account
subscriber-not-foundThis account does not exist
subscriber-internal-errorIssue during the processing. it can be: insufficient fund, timeout, wrong secret code...
generic-errorError during the processing of the transaction
subscriber-limit-reachedThis account has reached his limit
provider-application-problemIssue with service provider
provider-second-number-not-foundThe second number of this account is not a valid provider number
unknown-issueUnknown issue
subscriber-invalid-lengthThe phone number of this account is invalid
subscriber-invalid-min-amountThe amount is lower than the minimum amount allowed
subscriber-withdrawal-failedWhen failure during the money withdrawal
subscriber-timeoutOperation timeout
subscriber-invalid-secret-codeInvalid secret code
subscriber-invalid-max-amountThe transaction amount exceed the max allowed
invalid-amountTransaction amount is invalid