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

NameTypeDescription

Accept

String

application/json

V-PRIVATE-KEY*

String

Vesicash private key

V-PUBLIC-KEY*

String

Vesicash public key

Request Body

NameTypeDescription

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

{
    "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"
    ]
}

Last updated