Kiuru MSSP

MSS API

AUTHORIZATIONBasic Auth

Username

Password

POSTSynch SignatureReq to sign hash

https://demo.methics.fi/restapi

Request MSSP to sign a hash (e.g. document hash).

This request is synchronous and will return a response after the user has entered their PIN.

AUTHORIZATIONBasic Auth

This request is using Basic Auth from folderMSS API

Bodyraw (json)

json

{
    "MSS_SignatureReq": {
        "MobileUser": {
            "MSISDN": "{{msisdn}}"
        },
        "MessagingMode": "synch",
        "DataToBeDisplayed": {
            "MimeType": "text/plain",
            "Encoding": "UTF-8",
            "Data": "sign this"
        },
        "DataToBeSigned": {
            "MimeType": "application/x-sha256",
            "Encoding": "Base64",
            "Data": "n4bQgYhMfWWaL+qgxVrQFaO/TxsrC4Is0V1sFbDwCgg="
        },
        "SignatureProfile": "http://alauda.mobi/nonRepudiation",
        "AdditionalServices": [
            {
                "Description": "http://uri.etsi.org/TS102204/v1.1.2#validate"
            }
        ]
    }
}

POSTSynch signatureReq to authenticate

https://demo.methics.fi/restapi

Request MSSP to authenticate.

This request is synchronous and will return a response after user has entered their PIN.

AUTHORIZATIONBasic Auth

This request is using Basic Auth from folderMSS API

Bodyraw (json)

json

{
    "MSS_SignatureReq": {
        "MobileUser": {
            "MSISDN": "{{msisdn}}"
        },
        "MessagingMode": "synch",
        "DataToBeSigned": {
            "MimeType": "text/plain",
            "Encoding": "UTF-8",
            "Data": "Please authenticate this"
        },
        "SignatureProfile": "http://alauda.mobi/digitalSignature",
        "AdditionalServices": [
            {
                "Description": "http://uri.etsi.org/TS102204/v1.1.2#validate"
            },
            {
                "Description": "http://mss.ficom.fi/TS102204/v1.0.0#userLang",
                "UserLang": {
                    "Value": "EN"
                }
            }
        ]
    }
}

POSTReceipt message after sign

https://demo.methics.fi/restapi

Send a confirmation message to user after signing.

AUTHORIZATIONBasic Auth

This request is using Basic Auth from folderMSS API

Bodyraw (json)

json

{
    "MSS_ReceiptReq": {
        "AP_Info": {
            "AP_ID": "{{AP_ID}}",
            "AP_TransID": "doloribus",
            "Instant": "2025-04-05T06:32:48.558Z"
        },
        "MSSP_Info": {
            "MSSP_ID": {
                "URI": "{{MSSP_ID_URI}}"
            }
        },
        "MajorVersion": "1",
        "MinorVersion": "1",
        "MSSP_TransID": "{{MSSP_TransID}}",
        "Message": {
            "MimeType": "text/plain",
            "Encoding": "UTF-8",
            "Data": "Receipt message"
        },
        "MobileUser": {
            "MSISDN": "{{msisdn}}"
        }
    }
}