2. KnowSystem


DiVert Functionality

 
The Divert API has a parameter “CreateTransactionUrl” that can be set to either “True or “False”. The value set determines how the Gateway handles and processes the message request.

Scenario 1
If CreateTransactionUrl” is set to“True” - the Gateway generates a transaction URL and makes a callback to the merchant with the URL.
The merchant can then construct and format their own message, including the URL (returned by the Gateway) and distribute the message to their cardholder using either SMS|Email
When the cardholder receives the messages, it will have all the particulars of the merchant, the cardholder can then click on the URL, and be redirected to a payment page wherein they can make a payment to the merchant

Scenario 2
If CreateTransactionUrl is set to “False” – the Gateway processes the request, packages the payment request and distributes into the cardholder’s specified email address on behalf of the merchant
When the cardholder receives the messages, it will have all the particulars of the merchant, the cardholder can then click on the URL and be redirected to a payment page wherein they can make a payment to the merchant

Divert - Payment Link Parameters
The below table parameters carry one the following definitions and descriptions can be referenced on https://www.iveri.co.za/slides/slide/parameter-description-559 and where API and their structure resides on https://www.iveri.co.za/slides/slide/rest-api-649


Mandatory

O

Optional

C

Conditional

blank

not relevant


DiVert Parameter per Action

t

Parameter

RequestForDebit

RequestForAuthorisation

Core

ApplicationID

M

M

Core

Category

M

M

Core

CertificateID

M

M

Core

Gateway

O

O

Core

Command

M

M

Core

Mode

M

M

Common

Amount

M

M

Common

Currency

M

M

Common

MerchantReference

M

M

Common

CardholderName

M

M

Common

CardholderEmail

C

C

Common

OrderDescription

O

O

Common

AllowBudgetPeriod

O

O

Common

RequestExpiryDate

O

O

Common

CreateTransactionUrl

O

O


DiVert Sample Request/Response


                                                                                                REST

                                                                                                        REQUEST

{

    "Version": "2.0",

    "CertificateID": "{c5fb89bb-d823-4204-8df8-c0485ac9e113}",

    "ProductType": "Enterprise",

    "ProductVersion": "WebAPI",

    "Direction": "Request",

    "Enquiry": {

        "ApplicationID": "{e879975b-df4a-4e13-8ed1-102579581827}",

        "Command": "RequestForDebit",

        "Mode": "Test",

        "MerchantReference": "20220226_1225",

        "Amount":"2000",

        "Currency":"ZAR",

        "OrderDescription":"Check1",

        "AllowBudgetPeriod":"False",

        "CardholderName":"Kersh",

        "ardholderEmail": "test@hotmail.com",

        "RequestExpiryDate": "20230201",

        "CreateTransactionUrl": "True"

    }

}

 

                                                                                                                   RESPONSE

{

    "Version": "2.0",

    "Direction": "Response",

    "Enquiry": {

        "MerchantReference": "20220226_1225",

        "TransactionUrl": 

"https://portal.nedsecure.co.za/DiVert/Authorise.aspx?RequestId=9F5DD3CA-5195-4957-A9E6-79FFF5E021BD&SecurityToken=OGlIUU5ETkNtOEZMTG9xcGhQTUNiNmxwUGVuRUtLRy9aWktXNEZHSmJRaz01",

        "ApplicationID": "{E879975B-DF4A-4E13-8ED1-102579581827}",

        "Command": "RequestForDebit",

        "Mode": "Test",

        "RequestID": "{3C35B9CF-ACC6-416D-8A1C-0EDB1D61B592}",

        "Result": {

            "Status": "0",

            "Code": "0",

            "Description": "",

            "AppServer": "105IVERIAPPPR2N",

            "DBServer": "105iveridbpr01n",

            "Gateway": "Nedbank"

        }

    }

}

 


                                                                       SOAP

                                                                                                 REQUEST

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xmlns:xsd="http://www.w3.org/2001/XMLSchema"

 xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

  <soapenv:Body>

  <Execute xmlns="http://iveri.com/">

  <validateRequest>false</validateRequest>

  <protocol>V_XML</protocol>

  <protocolVersion>7.0</protocolVersion>

  <request>&lt;V_XML Version="2.0" CertificateID="3c993f-71dd-4044-802d-6e234effe8f2" ProductType="Enterprise"

ProductVersion="iVeriWebService" Direction="Request"&gt;

&lt;Enquiry ApplicationID="ec5729c-1d35-4208-86df-61c85cd447ae" Command="RequestForDebit" Mode="LIVE"&gt;

&lt;Amount&gt;3100&lt;/Amount&gt;

&lt;Currency&gt;ZAR&lt;/Currency&gt;

&lt;MerchantReference&gt;20290516.1241&lt;/MerchantReference&gt;

&lt;OrderDescription&gt;Bu:20260104.0922&lt;/OrderDescription&gt;

&lt;AllowBudgetPeriod&gt;&lt;/AllowBudgetPeriod&gt;

&lt;CardHolderName&gt;TestUser&lt;/CardHolderName&gt;

&lt;CardholderEmail&gt;test@gmail.com&lt;/CardholderEmail&gt;

&lt;RequestExpiryDate&gt;2025025&lt;/RequestExpiryDate&gt;

&lt;CreateTransactionUrl&gt;True&lt;/CreateTransactionUrl&gt;

&lt;/Enquiry&gt;

&lt;/V_XML&gt;

</request>

  </Execute>

</soapenv:Body>

</soapenv:Envelope>

                                                                                                            RESPONSE

<?xml version="1.0" encoding="utf-8"?><soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">    <soap:Body>  <ExecuteResponse xmlns="http://iveri.com/">            

<ExecuteResult>&lt;V_XML Version="2.0" Direction="Response"&gt;  &lt;Enquiry ApplicationID="{E157729C-1D35-4208-86DF-61C85CD447AE}" Command="RequestForDebit" Mode="Live" RequestID=" {0E248DED-3F9F-47EC-A13D-4513CD9F8CBE} "&gt;    &lt;Result Status="0" Code="0" Description="" AppServer="QA2019GWAPP01" DBServer="QA2019GWDB02" Gateway="QA" 

/&gt; &lt;MerchantReference&gt;20290516.1241&lt;/MerchantReference&gt; &lt;/TransactionUrl &gt;https://portal.iveri.net/DiVert/Authorise.aspx?

RequestId=43BD2F43-52FB-4638-9588-C349CC106D85&amp;amp;SecurityToken=cERub2NhOHVYTVV0YTVXMVRFdUpQOWNzbmpoREplR3RkeW4wc2VlWTVyOD01

&lt;/TransactionUrl&gt; &gt;  &lt;/Enquiry&gt;&lt;/V_XML&gt;</ExecuteResult> </ExecuteResponse>    </soap:Body></soap:Envelope>