Initiate MoR checkout

To create MoR checkout for a deployed country, the API will need some data payload sent, these data includes:

country_code

This is the country code of the MoR country of deployment, for example "NG"

currency_code

This is the abbreviated currency representation of the MoR country, for example "NGN"/

amount

This is the total amount for product sold or services rendered, excluding VAT

redirect_url

This is the webpage the end user will be redirected to after successfully confirming their payment

shipping_types

The shipping types caters for shipping data available for the product; the name of the shipping method, the time, amount and currency, will be displayed on the checkout page to the user. An example of the shipping_types payload is:

Available payment methods includes: card, banktransfer, mobilemoney, mobilemoneyghana, mobilemoneyzambia, mpesa

POST https://api.vesicash.com/v2/initiate-checkout

Initializing MoR checkout

Headers

Name	Type	Description
Accept	String	application/json
V-PRIVATE-KEY*	String	Vesicash private key
V-PUBLIC-KEY*	String	Vesicash public key

Request Body

Name	Type	Description
country_code*	String
currency_code*	String
amount*	String
redirect_url*	String
logo_url	String
background_colour	String
button_colour	String
request_phone_number	String
request_country	String
request_street_address	String
shipping_types	String
product_type	String
description	String
vat	String
payment_methods*	String

200: OK

{
    "status": "success",
    "code": 200,
    "message": "successful",
    "data": {
        "link": "https://app.vesicash.com/mor-checkout/MOR_PAY_a62c9abdc32648568c07",
        "Reference": "MOR_PAY_a62c9abdc32648568c07"
    }
}

To create MoR checkout here is a sample request payload below:

{
    "logo_url": "",
    "module_name": "",
    "business_name": "",
    "background_colour": "#f1f7f6",
    "button_colour": "#043b56",
    "request_phone_number": true,
    "request_country": false,
    "request_street_address": false,
    "country_id": 248,
    "country_name": "South Africa",
    "country_code": "ZA",
    "currency_code": "ZAR",
    "currency_sign": "R",
    "is_shipping_type": true,
    "shipping_types": [
        {
            "name": "Door delivery",
            "time": "2hrs",
            "amount": 200,
            "currency_code": "ZAR (R)"
        }
    ],
    "product_type": "",
    "amount": 1000,
    "vat": 20,
    "payment_methods": [
        "card"
    ]
}