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

| Language | Repository | |------------|--------------------------------------------------| | PHP | https://github.com/hachther/mesomb-php | | JavaScript | https://github.com/hachther/mesomb-js-client | | Python | https://github.com/hachther/mesomb-python-client | | Java | https://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.

| Framework | Link | |-------------|------------------------------------------------------| | WooCommerce | https://wordpress.org/plugins/mesomb-for-woocommerce | | Laravel | https://github.com/hachther/laravel-mesomb | | Odoo POS | https://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.

PS: Your webhook will be disabled after 3 failures (failure is when we receive HTTP response different from 200)

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:

| Code | Description | |----------------------------------|------------------------------------------------------------------------------------------| | subscriber-insufficient-balance | insufficient balance in the account | | subscriber-not-found | This account does not exist | | subscriber-internal-error | Issue during the processing. it can be: insufficient fund, timeout, wrong secret code... | | generic-error | Error during the processing of the transaction | | subscriber-limit-reached | This account has reached his limit | | provider-application-problem | Issue with service provider | | provider-second-number-not-found | The second number of this account is not a valid provider number | | unknown-issue | Unknown issue | | subscriber-invalid-length | The phone number of this account is invalid | | subscriber-invalid-min-amount | The amount is lower than the minimum amount allowed | | subscriber-withdrawal-failed | When failure during the money withdrawal | | subscriber-timeout | Operation timeout | | subscriber-invalid-secret-code | Invalid secret code | | subscriber-invalid-max-amount | The transaction amount exceed the max allowed | | invalid-amount | Transaction amount is invalid |