MB WAY 1.0.0

0
No votes yet

The MB WAY API requests the MB WAY enabled App, associated with the mobile phone number sent within the request, to accept the payment. The response indicates the status of the notification to the MB WAY user. The payment only happens after MB WAY user acceptance.

forum Discuss this API in the forum
production
development
https://site1.sibsapimarket.com:8445/sibs-qly/apimarket-sb
production
development
https://site2.sibsapimarket.com:8445/sibs-qly/apimarket-sb
production
development
https://sandbox.qly.sibspayments.com

Paths

/{id}/mbway-id/purchase

post /{id}/mbway-id/purchase
input
Required in body
object
id
Required in path
string
Content-Type
Optional in header
string
application/json
text/plain
Accept
Optional in header
string
application/json
text/plain
200

200 OK

ResponsePayment
Example Request
curl --request POST \
  --url https://site1.sibsapimarket.com:8445/sibs-qly/apimarket-sb/sibs/spg/v1/payments/REPLACE_ID/mbway-id/purchase \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{"customerPhone":"351#912345678","info":{"deviceInfo":{"browserAcceptHeader":"347466772585829","browserJavaEnabled":"agvipu","browserLanguage":"GU","browserColorDepth":"#ed39c4","browserScreenHeight":"ovivefcomfegobu","browserScreenWidth":"690467800875008","browserTZ":"eztamogw","browserUserAgent":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36","systemFamily":"rijcujuknelfomi","systemVersion":"ruczaokio","systemArchitecture":"ricfitoejfokm","deviceManufacturer":"uwufreravuzjo","deviceModel":"beczomoref","deviceID":"534627024371712","applicationName":"Matilda Byrd","applicationVersion":"duwubojrei","geoLocalization":"cibfe","ipAddress":"220.35.245.128"},"customerInfo":[{"key":"moligofu","value":"74.41"},{"key":"gewk","value":"90.92"},{"key":"kecu","value":"62.41"}]},"actionProcessed":{"id":"3168666707296256","type":"THREEDS_METHOD","executed":false}}'
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://site1.sibsapimarket.com:8445/sibs-qly/apimarket-sb/sibs/spg/v1/payments/REPLACE_ID/mbway-id/purchase")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request = Net::HTTP::Post.new(url)
request["content-type"] = 'application/json'
request["accept"] = 'application/json'
request.body = "{\"customerPhone\":\"351#912345678\",\"info\":{\"deviceInfo\":{\"browserAcceptHeader\":\"347466772585829\",\"browserJavaEnabled\":\"agvipu\",\"browserLanguage\":\"GU\",\"browserColorDepth\":\"#ed39c4\",\"browserScreenHeight\":\"ovivefcomfegobu\",\"browserScreenWidth\":\"690467800875008\",\"browserTZ\":\"eztamogw\",\"browserUserAgent\":\"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36\",\"systemFamily\":\"rijcujuknelfomi\",\"systemVersion\":\"ruczaokio\",\"systemArchitecture\":\"ricfitoejfokm\",\"deviceManufacturer\":\"uwufreravuzjo\",\"deviceModel\":\"beczomoref\",\"deviceID\":\"534627024371712\",\"applicationName\":\"Matilda Byrd\",\"applicationVersion\":\"duwubojrei\",\"geoLocalization\":\"cibfe\",\"ipAddress\":\"220.35.245.128\"},\"customerInfo\":[{\"key\":\"moligofu\",\"value\":\"74.41\"},{\"key\":\"gewk\",\"value\":\"90.92\"},{\"key\":\"kecu\",\"value\":\"62.41\"}]},\"actionProcessed\":{\"id\":\"3168666707296256\",\"type\":\"THREEDS_METHOD\",\"executed\":false}}"

response = http.request(request)
puts response.read_body
import http.client

conn = http.client.HTTPSConnection("site1.sibsapimarket.com:8445")

payload = "{\"customerPhone\":\"351#912345678\",\"info\":{\"deviceInfo\":{\"browserAcceptHeader\":\"347466772585829\",\"browserJavaEnabled\":\"agvipu\",\"browserLanguage\":\"GU\",\"browserColorDepth\":\"#ed39c4\",\"browserScreenHeight\":\"ovivefcomfegobu\",\"browserScreenWidth\":\"690467800875008\",\"browserTZ\":\"eztamogw\",\"browserUserAgent\":\"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36\",\"systemFamily\":\"rijcujuknelfomi\",\"systemVersion\":\"ruczaokio\",\"systemArchitecture\":\"ricfitoejfokm\",\"deviceManufacturer\":\"uwufreravuzjo\",\"deviceModel\":\"beczomoref\",\"deviceID\":\"534627024371712\",\"applicationName\":\"Matilda Byrd\",\"applicationVersion\":\"duwubojrei\",\"geoLocalization\":\"cibfe\",\"ipAddress\":\"220.35.245.128\"},\"customerInfo\":[{\"key\":\"moligofu\",\"value\":\"74.41\"},{\"key\":\"gewk\",\"value\":\"90.92\"},{\"key\":\"kecu\",\"value\":\"62.41\"}]},\"actionProcessed\":{\"id\":\"3168666707296256\",\"type\":\"THREEDS_METHOD\",\"executed\":false}}"

headers = {
    'content-type': "application/json",
    'accept': "application/json"
    }

conn.request("POST", "/sibs-qly/apimarket-sb/sibs/spg/v1/payments/REPLACE_ID/mbway-id/purchase", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "8445",
  CURLOPT_URL => "https://site1.sibsapimarket.com:8445/sibs-qly/apimarket-sb/sibs/spg/v1/payments/REPLACE_ID/mbway-id/purchase",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"customerPhone\":\"351#912345678\",\"info\":{\"deviceInfo\":{\"browserAcceptHeader\":\"347466772585829\",\"browserJavaEnabled\":\"agvipu\",\"browserLanguage\":\"GU\",\"browserColorDepth\":\"#ed39c4\",\"browserScreenHeight\":\"ovivefcomfegobu\",\"browserScreenWidth\":\"690467800875008\",\"browserTZ\":\"eztamogw\",\"browserUserAgent\":\"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36\",\"systemFamily\":\"rijcujuknelfomi\",\"systemVersion\":\"ruczaokio\",\"systemArchitecture\":\"ricfitoejfokm\",\"deviceManufacturer\":\"uwufreravuzjo\",\"deviceModel\":\"beczomoref\",\"deviceID\":\"534627024371712\",\"applicationName\":\"Matilda Byrd\",\"applicationVersion\":\"duwubojrei\",\"geoLocalization\":\"cibfe\",\"ipAddress\":\"220.35.245.128\"},\"customerInfo\":[{\"key\":\"moligofu\",\"value\":\"74.41\"},{\"key\":\"gewk\",\"value\":\"90.92\"},{\"key\":\"kecu\",\"value\":\"62.41\"}]},\"actionProcessed\":{\"id\":\"3168666707296256\",\"type\":\"THREEDS_METHOD\",\"executed\":false}}",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "content-type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"customerPhone\":\"351#912345678\",\"info\":{\"deviceInfo\":{\"browserAcceptHeader\":\"347466772585829\",\"browserJavaEnabled\":\"agvipu\",\"browserLanguage\":\"GU\",\"browserColorDepth\":\"#ed39c4\",\"browserScreenHeight\":\"ovivefcomfegobu\",\"browserScreenWidth\":\"690467800875008\",\"browserTZ\":\"eztamogw\",\"browserUserAgent\":\"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36\",\"systemFamily\":\"rijcujuknelfomi\",\"systemVersion\":\"ruczaokio\",\"systemArchitecture\":\"ricfitoejfokm\",\"deviceManufacturer\":\"uwufreravuzjo\",\"deviceModel\":\"beczomoref\",\"deviceID\":\"534627024371712\",\"applicationName\":\"Matilda Byrd\",\"applicationVersion\":\"duwubojrei\",\"geoLocalization\":\"cibfe\",\"ipAddress\":\"220.35.245.128\"},\"customerInfo\":[{\"key\":\"moligofu\",\"value\":\"74.41\"},{\"key\":\"gewk\",\"value\":\"90.92\"},{\"key\":\"kecu\",\"value\":\"62.41\"}]},\"actionProcessed\":{\"id\":\"3168666707296256\",\"type\":\"THREEDS_METHOD\",\"executed\":false}}");
Request request = new Request.Builder()
  .url("https://site1.sibsapimarket.com:8445/sibs-qly/apimarket-sb/sibs/spg/v1/payments/REPLACE_ID/mbway-id/purchase")
  .post(body)
  .addHeader("content-type", "application/json")
  .addHeader("accept", "application/json")
  .build();

Response response = client.newCall(request).execute();
const request = require('request');

const options = {
  method: 'POST',
  url: 'https://site1.sibsapimarket.com:8445/sibs-qly/apimarket-sb/sibs/spg/v1/payments/REPLACE_ID/mbway-id/purchase',
  headers: {'content-type': 'application/json', accept: 'application/json'},
  body: {
    customerPhone: '351#912345678',
    info: {
      deviceInfo: {
        browserAcceptHeader: '347466772585829',
        browserJavaEnabled: 'agvipu',
        browserLanguage: 'GU',
        browserColorDepth: '#ed39c4',
        browserScreenHeight: 'ovivefcomfegobu',
        browserScreenWidth: '690467800875008',
        browserTZ: 'eztamogw',
        browserUserAgent: 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36',
        systemFamily: 'rijcujuknelfomi',
        systemVersion: 'ruczaokio',
        systemArchitecture: 'ricfitoejfokm',
        deviceManufacturer: 'uwufreravuzjo',
        deviceModel: 'beczomoref',
        deviceID: '534627024371712',
        applicationName: 'Matilda Byrd',
        applicationVersion: 'duwubojrei',
        geoLocalization: 'cibfe',
        ipAddress: '220.35.245.128'
      },
      customerInfo: [
        {key: 'moligofu', value: '74.41'},
        {key: 'gewk', value: '90.92'},
        {key: 'kecu', value: '62.41'}
      ]
    },
    actionProcessed: {id: '3168666707296256', type: 'THREEDS_METHOD', executed: false}
  },
  json: true
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://site1.sibsapimarket.com:8445/sibs-qly/apimarket-sb/sibs/spg/v1/payments/REPLACE_ID/mbway-id/purchase"

	payload := strings.NewReader("{\"customerPhone\":\"351#912345678\",\"info\":{\"deviceInfo\":{\"browserAcceptHeader\":\"347466772585829\",\"browserJavaEnabled\":\"agvipu\",\"browserLanguage\":\"GU\",\"browserColorDepth\":\"#ed39c4\",\"browserScreenHeight\":\"ovivefcomfegobu\",\"browserScreenWidth\":\"690467800875008\",\"browserTZ\":\"eztamogw\",\"browserUserAgent\":\"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36\",\"systemFamily\":\"rijcujuknelfomi\",\"systemVersion\":\"ruczaokio\",\"systemArchitecture\":\"ricfitoejfokm\",\"deviceManufacturer\":\"uwufreravuzjo\",\"deviceModel\":\"beczomoref\",\"deviceID\":\"534627024371712\",\"applicationName\":\"Matilda Byrd\",\"applicationVersion\":\"duwubojrei\",\"geoLocalization\":\"cibfe\",\"ipAddress\":\"220.35.245.128\"},\"customerInfo\":[{\"key\":\"moligofu\",\"value\":\"74.41\"},{\"key\":\"gewk\",\"value\":\"90.92\"},{\"key\":\"kecu\",\"value\":\"62.41\"}]},\"actionProcessed\":{\"id\":\"3168666707296256\",\"type\":\"THREEDS_METHOD\",\"executed\":false}}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("content-type", "application/json")
	req.Header.Add("accept", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
import Foundation

let headers = [
  "content-type": "application/json",
  "accept": "application/json"
]
let parameters = [
  "customerPhone": "351#912345678",
  "info": [
    "deviceInfo": [
      "browserAcceptHeader": "347466772585829",
      "browserJavaEnabled": "agvipu",
      "browserLanguage": "GU",
      "browserColorDepth": "#ed39c4",
      "browserScreenHeight": "ovivefcomfegobu",
      "browserScreenWidth": "690467800875008",
      "browserTZ": "eztamogw",
      "browserUserAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36",
      "systemFamily": "rijcujuknelfomi",
      "systemVersion": "ruczaokio",
      "systemArchitecture": "ricfitoejfokm",
      "deviceManufacturer": "uwufreravuzjo",
      "deviceModel": "beczomoref",
      "deviceID": "534627024371712",
      "applicationName": "Matilda Byrd",
      "applicationVersion": "duwubojrei",
      "geoLocalization": "cibfe",
      "ipAddress": "220.35.245.128"
    ],
    "customerInfo": [
      [
        "key": "moligofu",
        "value": "74.41"
      ],
      [
        "key": "gewk",
        "value": "90.92"
      ],
      [
        "key": "kecu",
        "value": "62.41"
      ]
    ]
  ],
  "actionProcessed": [
    "id": "3168666707296256",
    "type": "THREEDS_METHOD",
    "executed": false
  ]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://site1.sibsapimarket.com:8445/sibs-qly/apimarket-sb/sibs/spg/v1/payments/REPLACE_ID/mbway-id/purchase")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error)
Show more open_in_new
Example Response
POST https://site1.sibsapimarket.com:8445/sibs-qly/apimarket-sb/sibs/spg/v1/payments/{id}/mbway-id/purchase
{
  "returnStatus": {
    "statusCode": "000",
    "statusMsg": "Success",
    "statusDescription": "Oki adibimra saddib gicewwam ep tisokdi gecbiof bidvo gokockav cagjawpu dol zimzidwab vufzut zirej gecogjeg no melgozna sa."
  },
  "transactionID": "42f59038f3f14e618d091da8bf3b717e9999",
  "merchant": {
    "terminalId": "21451",
    "channel": "web",
    "merchantTransactionId": "863b730df285443f9a60ca404e0085fd1234"
  },
  "paymentType": "tavanbomelepa",
  "actionResponse": {
    "id": "779223331504128",
    "type": "tiwrawekedca",
    "data": {
      "url": "http://wuc.is/uzodeca",
      "params": [
        {
          "name": "Walter Washington",
          "data": "ifbih"
        },
        {
          "name": "Dorothy Parks",
          "data": "julupdo"
        },
        {
          "name": "Abbie Summers",
          "data": "fesajawunkatjapa"
        }
      ]
    }
  },
  "recurringTransaction": {
    "status": "Success"
  },
  "execution": {
    "startTime": "2020-07-15T12:10
Show more open_in_new
Try this operation
https://site1.sibsapimarket.com:8445/sibs-qly/apimarket-sb/sibs/spg/v1/payments/{id}/mbway-id/purchase
content-type
accept
id

Definitions 

{
    "properties": {
        "id": {
            "type": "string"
        },
        "type": {
            "type": "string",
            "example": "THREEDS_METHOD",
            "enum": [
                "THREEDS_METHOD",
                "THREEDS_CHALLENGE"
            ]
        },
        "executed": {
            "type": "boolean"
        }
    },
    "additionalProperties": false
}
              
{
    "properties": {
        "id": {
            "type": "string"
        },
        "type": {
            "type": "string"
        },
        "data": {
            "$ref": "#/definitions/Data"
        }
    },
    "additionalProperties": false
}
              
{
    "properties": {
        "url": {
            "type": "string"
        },
        "params": {
            "type": "array",
            "items": {
                "$ref": "#/definitions/Parameter"
            }
        }
    },
    "additionalProperties": false
}

Object that defines the customer device information.

{
    "properties": {
        "browserAcceptHeader": {
            "type": "string"
        },
        "browserJavaEnabled": {
            "type": "string"
        },
        "browserLanguage": {
            "type": "string"
        },
        "browserColorDepth": {
            "type": "string"
        },
        "browserScreenHeight": {
            "type": "string"
        },
        "browserScreenWidth": {
            "type": "string"
        },
        "browserTZ": {
            "type": "string"
        },
        "browserUserAgent": {
            "type": "string"
        },
        "systemFamily": {
            "type": "string"
        },
        "systemVersion": {
            "type": "string"
        },
        "systemArchitecture": {
            "type": "string"
        },
        "deviceManufacturer": {
            "type": "string"
        },
        "deviceModel": {
            "type": "string"
        },
        "deviceID": {
            "type": "string"
        },
        "applicationName": {
            "type": "string"
        },
        "applicationVersion": {
            "type": "string"
        },
        "geoLocalization": {
            "type": "string"
        },
        "ipAddress": {
            "type": "string"
        }
    },
    "additionalProperties": false
}

Key value tuple.

{
    "type": "object",
    "properties": {
        "key": {
            "type": "string"
        },
        "value": {
            "type": "string"
        }
    }
}

Object that defines the transaction additional information

{
    "properties": {
        "deviceInfo": {
            "$ref": "#/definitions/Deviceinfo",
            "description": "Object that defines the customers device predefined information. Check the DeviceInfo definition."
        },
        "customerInfo": {
            "type": "array",
            "items": {
                "$ref": "#/definitions/ExtendedInfo"
            },
            "description": "Key Value tuple array."
        }
    },
    "additionalProperties": false
}

Object that defines a Merchant.

{
    "properties": {
        "terminalId": {
            "type": "integer",
            "example": "21451",
            "description": "Number of the merchant pos Id.",
            "format": "int32"
        },
        "channel": {
            "type": "string",
            "description": "Type of channel used by the merchant.",
            "example": "web"
        },
        "merchantTransactionId": {
            "type": "string",
            "description": "Unique id used by the merchant.",
            "example": "863b730df285443f9a60ca404e0085fd1234"
        }
    },
    "additionalProperties": false
}
              
{
    "type": "object",
    "properties": {
        "name": {
            "type": "string"
        },
        "data": {
            "type": "string"
        }
    },
    "additionalProperties": false
}

Object that defines the payment operation request fields

{
    "properties": {
        "customerPhone": {
            "type": "string",
            "description": "Customer's phone number.",
            "example": "351#912345678"
        },
        "info": {
            "$ref": "#/definitions/Info",
            "description": "Object that defines the aditional info provided by the merchant. Check the Info definition."
        },
        "actionProcessed": {
            "description": "Action to be processed",
            "$ref": "#/definitions/ActionProcessed"
        }
    },
    "additionalProperties": false
}

Object that defines the payment operation return fields

{
    "properties": {
        "returnStatus": {
            "description": "Object that defines the Status of the transaction. Check the ReturnStatus definition.",
            "$ref": "#/definitions/ReturnStatus"
        },
        "transactionID": {
            "type": "string",
            "description": "Unique identify of the transaction.",
            "example": "42f59038f3f14e618d091da8bf3b717e9999"
        },
        "merchant": {
            "description": "Object that defines the Merchant. Check the Merchant definition.",
            "$ref": "#/definitions/Merchant"
        },
        "paymentType": {
            "type": "string",
            "description": "Payment type used"
        },
        "actionResponse": {
            "description": "Action to perform",
            "$ref": "#/definitions/ActionReponse"
        },
        "recurringTransaction": {
            "description": "Object that defines a Recurring Transaction. Check the Recurring Transaction definition.",
            "$ref": "#/definitions/RecurringTransactionOutput"
        },
        "execution": {
            "description": "Object that defines an Execution. See the Execution definition.",
            "example": "",
            "$ref": "#/definitions/Execution"
        },
        "paymentStatus": {
            "type": "string",
            "description": "Status of the payment."
        }
    },
    "additionalProperties": false
}

Object that defines the status of the processed transaction.

{
    "properties": {
        "statusCode": {
            "type": "string",
            "description": "Identifier code of the processed transaction status.",
            "example": "000"
        },
        "statusMsg": {
            "type": "string",
            "description": "Message of the processed transaction status.",
            "example": "Success"
        },
        "statusDescription": {
            "type": "string",
            "description": "Description of the processed transaction status."
        }
    },
    "additionalProperties": false
}

Object that encapsulates technical execution information.

{
    "properties": {
        "startTime": {
            "type": "string",
            "description": "Time of the acceptance of the request by the API.",
            "format": "date-time",
            "example": "2020-07-15T12:10:49.131+01:00"
        },
        "endTime": {
            "type": "string",
            "description": "Time of the response to the request by the API.",
            "format": "date-time",
            "example": "2020-07-15T12:10:49.131+01:00"
        }
    },
    "additionalProperties": false
}
              
{
    "properties": {
        "status": {
            "type": "string",
            "description": "Recurring Transaction outcome.",
            "example": "Success"
        }
    },
    "additionalProperties": false
}