Basis Specifications
Some specifications to help you understand the MeSomb API and integrate it into your product.
Supported format
- All responses from the MeSomb API are returned as JSON
- POST requests to the server are to be sent as JSON but also as form data (if the request contains a file)
HTTP Response Codes
Status codes are returned as default HTTP codes.
| Status Code | Description |
|---|---|
| 200 OK | Standard response for successful requests. Everything is ok |
| 400 Client Error | Error of client calling the MeSomb API – please check the error message returned from MeSomb API to correct the wrong request |
| 500 Server Error | The server failed to fulfill an apparently valid request. This indicates an internal MeSomb API error. If encountered please contact MeSomb with steps on how the error was produced. |
Internationalization
The API support internationalization and currently, 2 languages a supported: French (fr) and English (en). By setting the language all messages (mainly error descriptions) received from MeSomb will be in the chosen language.
The language is set by adding language code at the beginning of the URL: en for English and fr for French. Example: https://business.mesomb.com/[en|fr]/api/v1.1/payment/collect
Environments
This document will list web services by their relative path (e.g. GET /ping). You must create your service on MeSomb to have access to our API. Please Open a ticket in case of problems.
Your service is materialized in our system by an application. At the creation, your application is in DEVELOPMENT mode, which means you cannot perform any live transaction and can only use specific information provided in this document for testing.
When you are ready to submit your app, go into our go-live live process and once approved you will be ready to go.
SSL
All requests on the system are to be sent via HTTPS only to encrypt all messages over the network.
Cross-Origin Resource Sharing
MeSomb API features Cross-Origin Resource Sharing (CORS) implemented in compliance with W3C spec. And that allows cross-domain communication from the browser. All responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site.