Get started

    API Endpoint

    https://leanov8.co.za/api/noty/w/send/
                

The Notification API makes it easy to send an SMS Notification and allows the receiver to approve or disapprove the transaction request in the SMS.

To use this API, you need an API key. Please contact us at info@leanov8.co.za to get your own API key.

Send SMS

# Here is an example of the required xml data
    <Request>
        <key>Your API key</key>
        <to>0610000000</to>
        <sender>0600000000</sender>
        <description>this is a description</description>
        <transaction_id>10B1AAA</transaction_id>
        <notify_url>https:mynotificationurl.co.za</notify_url>
        <passPhrase>GDF354hDD</passPhrase> 
    </Request>

                

To send an SMS you need to make a POST call to the following url:
https://leanov8.co.za/api/noty/w/send/

Result example :
            <Response>
            <ResponseCode></ResponseCode>
            <ResponseMessage>Success</ResponseMessage>
        </Response>
    
    


The XML data POST back to the notify_url
    Result example :
            <Response>
            <sid></sid>
            <status></status>
            <domain></domain>
            <to></to>
            <sender></sender>
            <message></message>
            <transaction_id></transaction_id>
            <passPhrase></passPhrase>
            <date></date>
        </Response>
    
                

QUERY PARAMETERS

Field	Type	Description
key	String	Your API key.
to	String	The cell number to send the SMS to.
sender	String	The cell number of the sender.
description	String	The description of the request.
transaction_id	String	The transaction ID.
notify_url	String	A URL to POST data to upon an approved transaction.
passPhrase	String	The text that will be used to POST data to notify_url in order to validate the transaction

Errors

The Notification API uses the following error codes:

Error Code	Meaning
-100	Some parameters are missing. This error appears when you don't pass every mandatory parameters in the required format.
-1100	Something wrong with the parameters. This can be caused by an error in parsing the parameters.
-1101	Something wrong with the parameters. This can be caused by an error in parsing the parameters.