Transaction Message Examples

The examples apply when using the web service interface to perform various transactions. The examples serve to showcase a set of parameters that are largely used when performing transactions using the schema definition available in the SOAP interface which are also commonly used on the REST API. The functionality and related parameter definitions, elements supported are standard in the SOAP schema and REST API

Further insights on the transaction types and their meanings, refer to the “Commands” and “Actions” sections and these have to be used in conjunction with the input parameters per actions. For the corresponding transaction flows per transactions type refer to transaction sequence

The examples cover the following messages:

The transaction Request and Response cover the following:

The Request message shows all the elements that are most used. The examples that follow will use the mandatory elements from this message necessary to perform the respective transaction covered in the example.
The response message is a typical response received from the web service to the various request messages.

Sale – Debit with PAN

This where the cardholder is debited, and merchant account is credited by the acquiring bank or PSP that holds the merchant agreement

REST

Request

{

"Version": "2.0",

"CertificateID": "{5c4b9c74-0063-4240-9cff-f730675c5bd0}",

"ProductType": "Enterprise",

"ProductVersion": "WebAPI",

"Direction": "Request",

"Transaction": {

"ApplicationID": "{d8d5a94-8fa0-428d-a539-3a5baf166f7f}",

"Command": "Debit",

"Mode": "TEST",

"MerchantReference": "20221108_1029",

"MerchantTrace": "DIAAAY4734",

"Currency": "ZAR",

"Amount": "3000",

"ExpiryDate": "1025",

"PAN": "4242424242424242"

}

Response

{

"Version": "2.0",

"Direction": "Response",

"Transaction": {

"MerchantTrace": "DIAAAY4734",

"Amount": "3000",

"AuthorisationCode": "543305",

"CCNumber": "4242........4242",

"Currency": "ZAR",

"ExpiryDate": "102025",

"MerchantReference": "20221108_1029",

"Terminal": "Default",

"TransactionIndex": "{7C256903-9097-41AE-81B6-54681B33301F}",

"MerchantName": "iVeri Payment Technology",

"MerchantUSN": "7771777",

"Acquirer": "NBPostilionNBSouthAfrica",

"AcquirerReference": "95702:04641684",

"AcquirerDate": "20221229",

"AcquirerTime": "102825",

"DisplayAmount": "R 30.00",

"BIN": "4",

"Association": "VISA",

"CardType": "Unknown CardType",

"Issuer": "Unknown Issuer",

"Jurisdiction": "International",

"PAN": "4242........4242",

"PANMode": "Keyed",

"ReconReference": "04641684",

"CardHolderPresence": "CardNotPresent",

"MerchantAddress": "MERCHANT ADDRESS",

"MerchantCity": "Sandton",

"MerchantCountryCode": "ZA",

"MerchantCountry": "South Africa",

"DistributorName": "Nedbank",

"ApplicationID": "{D8D5A94-8FA0-428D-A539-3A5BAF166F7F}",

"Command": "Debit",

"Mode": "Test",

"RequestID": "{B6308E50-4337-4DFE-A0DC-A4B3C4732139}",

"Result": {

"Status": "0",

"Code": "0",

"Description": "",

"AppServer": "105IVERIAPPPR2N",

"DBServer": "105iveridbpr01n",

"Gateway": "Nedbank",

"AcquirerCode": "00",

"AcquirerDescription": ""

}

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/">

<soap:Body>

<validateRequest>false</validateRequest>

<V_XML Version="2.0" CertificateID="cf4b7e7a-4fec-43b4-a2cb-221263c0a34b"

ProductType="Enterprise" ProductVersion="iVeriWebService" Direction="Request">

</Transaction></V_XML>

</request>

</Execute>

</soap:Body>

</soap: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>

<Terminal>Default</Terminal>

<MerchantName>iVeri Payment Technology</MerchantName>

<Acquirer>NBPostilionNBSouthAfrica</Acquirer>

<CardType>Unknown CardType</CardType>

<Issuer>Unknown Issuer</Issuer>

<Jurisdiction>International</Jurisdiction>

<PANMode>Keyed</PANMode>

<CardHolderPresence>CardNotPresent</CardHolderPresence>

<MerchantAddress>MERCHANT ADDRESS</MerchantAddress>

<MerchantCity>Sandton</MerchantCity>

<MerchantCountry>South Africa</MerchantCountry>

<DistributorName>Nedbank</DistributorName>

</Transaction>

</V_XML></ExecuteResult>

</ExecuteResponse>

</soap:Body>

</soap:Envelope>

Sale – Debit with Transaction Index

REST

Request
{
"Version": "2.0",
"CertificateID": "{6C6D7349-F4F2-426B-A1B0-0E9E9558C7D7}",
"ProductType": "Enterprise",
"Direction": "Request",
"Transaction": {
"ApplicationID": "{12db8f85-87b7-456e-84cb-3e6bb1ebf0f6}",
"Command": "Debit ",
"Mode": "Live",
"MerchantReference": "B20250294-16434",
"Currency": "ZAR",
"Amount":"2100",
"ExpiryDate":"052027",
"CardSecurityCode":"",
"PAN": "4922........1852",
"PANFormat":"TransactionIndex",
"TransactionIndex": "{B1C23A5F-FDCC-4901-BD28-6B57F8B955F8}",
}

}

Response
{
"Version": "2.0",
"Direction": "Response",
"Transaction": {
"Amount": "2100",
"AuthorisationCode": "020046",
"CCNumber": "4922........1852",
"Currency": "ZAR",
"ExpiryDate": "052027",
"MerchantReference": "B20250294-16434",
"Terminal": "Default",
"TransactionIndex": "{FE210E9B-0923-4873-9363-DB31534DC9E5}",
"MerchantName": "iVeri",
"MerchantUSN": "1732460",
"Acquirer": "NBPostilionNBSouthAfrica",
"AcquirerReference": "03800:00127593",
"AcquirerDate": "20250808",
"AcquirerTime": "101512",
"DisplayAmount": "R 21.00",
"BIN": "49221300",
"Association": "VISA",
"CardType": "Credit Card",
"Issuer": "Unknown Issuer",
"Jurisdiction": "International",
"PAN": "4922........1852",
"PANMode": "Tokenized",
"ReconReference": "00127593",
"CardHolderPresence": "CardNotPresent,COF",
"MerchantAddress": "Pretoria",
"MerchantCity": "Isando",
"MerchantCountryCode": "ZA",
"MerchantCountry": "South Africa",
"DistributorName": "Nedbank",
"AcquirerTrace": "305220297119001",
"ApplicationID": "{12DB8F85-87B7-456E-84CB-3E6BB1EBF0F6}",
"Command": "Debit",
"Mode": "Live",
"RequestID": "{1CB699DD-DD36-4C33-B214-3664ADABE28F}",
"Result": {
"Status": "0",
"Code": "0",
"Description": "",
"AppServer": "QA2019GWAPP01",
"DBServer": "QA2019GWDB02",
"Gateway": "QA",
"AcquirerCode": "00",
"AcquirerDescription": ""
}
}
}

Pre-Auth – Authorisation with PAN

Reserve or withhold funds on the cardholders related card account

REST

Request

{

"Version": "2.0",

"CertificateID": "{5c4b9c74-0063-4240-9cff-f730675c5bd0}",

"ProductType": "Enterprise",

"ProductVersion": "WebAPI",

"Direction": "Request",

"Transaction": {

"ApplicationID": "{d8d5a94-8fa0-428d-a539-3a5baf166f7f}",

"Command": "Authorisation",

"Mode": "TEST",

"MerchantReference": "20221108_1042",

"MerchantTrace": "DIAAAY4QW2",

"Currency": "ZAR",

"Amount": "3000",

"ExpiryDate": "1025",

"PAN": "4242424242424242"

}

Response

{

"Version": "2.0",

"Direction": "Response",

"Transaction": {

"MerchantTrace": "DIAAAY4QW2",

"Amount": "3000",

"AuthorisationCode": "544161",

"CCNumber": "4242........4242",

"Currency": "ZAR",

"ExpiryDate": "102025",

"MerchantReference": "20221108_1042",

"Terminal": "Default",

"TransactionIndex": "{5C8F61BE-15AD-4201-B361-66AD52D2EFAE}",

"MerchantName": "iVeri Payment Technology",

"MerchantUSN": "7771777",

"Acquirer": "NBPostilionNBSouthAfrica",

"AcquirerReference": "95702:04641685",

"AcquirerDate": "20221229",

"AcquirerTime": "104241",

"DisplayAmount": "R 30.00",

"BIN": "4",

"Association": "VISA",

"CardType": "Unknown CardType",

"Issuer": "Unknown Issuer",

"Jurisdiction": "International",

"PAN": "4242........4242",

"PANMode": "Keyed",

"ReconReference": "04641685",

"CardHolderPresence": "CardNotPresent",

"MerchantAddress": "MERCHANT ADDRESS",

"MerchantCity": "Sandton",

"MerchantCountryCode": "ZA",

"MerchantCountry": "South Africa",

"DistributorName": "Nedbank",

"ApplicationID": "{D8D5A94-8FA0-428D-A539-3A5BAF166F7F}",

"Command": "Authorisation",

"Mode": "Test",

"RequestID": "{3D1860F1-86E1-4AE2-A8EA-EFC0D6A5B8AF}",

"Result": {

"Status": "0",

"Code": "0",

"Description": "",

"AppServer": "105IVERIAPPPR1N",

"DBServer": "105iveridbpr01n",

"Gateway": "Nedbank",

"AcquirerCode": "00",

"AcquirerDescription": ""

}

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/">

<soap:Body>

<validateRequest>false</validateRequest>

<V_XML Version="2.0" CertificateID="cf4b7e7a-4fec-43b4-a2cb-221263c0a34b"

ProductType="Enterprise" ProductVersion="iVeriWebService" Direction="Request">

<MerchantTrace>2407E27568ABEEE</MerchantTrace>

</Transaction></V_XML>

</request>

</Execute>

</soap:Body>

</soap: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>

<MerchantTrace>2407E27568ABEEE</MerchantTrace>

<Terminal>Default</Terminal>

<MerchantName>iVeri Payment Technology</MerchantName>

<Acquirer>NBPostilionNBSouthAfrica</Acquirer>

<CardType>Unknown CardType</CardType>

<Issuer>Unknown Issuer</Issuer>

<Jurisdiction>International</Jurisdiction>

<PANMode>Keyed</PANMode>

<CardHolderPresence>CardNotPresent</CardHolderPresence>

<MerchantAddress>MERCHANT ADDRESS</MerchantAddress>

<MerchantCity>Sandton</MerchantCity>

<MerchantCountry>South Africa</MerchantCountry>

<DistributorName>Nedbank</DistributorName>

</Transaction>

</V_XML></ExecuteResult>

</ExecuteResponse>

</soap:Body>

</soap:Envelope>

Pre-Auth Completion – Follow-up Debit

Allows the merchant to instruct the cardholders bank to release and debit the funds previously reserved or pre-authorized

REST

Request

{

    "Version": "2.0",

    "CertificateID": "{5c4b9c74-0063-4240-9cff-f730675c5bd0}",

    "ProductType": "Enterprise",

    "ProductVersion": "WebAPI",

    "Direction": "Request",

    "Transaction": {

        "ApplicationID": "{d8d5a94-8fa0-428d-a539-3a5baf166f7f}",

        "Command": "Debit",

        "Mode": "Test",

        "Amount": "1000",

        "MerchantTrace":"20220812_1044",

        "TransactionIndex": "{5C8F61BE-15AD-4201-B361-66AD52D2EFAE}"

    }

Response

{

    "Version": "2.0",

    "CertificateID": "{5c4b9c74-0063-4240-9cff-f730675c5bd0}",

    "ProductType": "Enterprise",

    "ProductVersion": "WebAPI",

    "Direction": "Request",

    "Transaction": {

        "ApplicationID": "{d8d5a94-8fa0-428d-a539-3a5baf166f7f}",

        "Command": "Debit",

        "Mode": "Test",

        "Amount": "1000",

        "MerchantTrace":"20220812_1044",

        "TransactionIndex": "{5C8F61BE-15AD-4201-B361-66AD52D2EFAE}"

    }

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/">

  <soap:Body>

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

  <validateRequest>false</validateRequest>

  <request><V_XML Version="2.0" CertificateID="cf4b7e7a-4fec-43b4-a2cb-221263c0a34b"

   ProductType="Enterprise" ProductVersion="iVeriWebService" Direction="Request">

<Transaction ApplicationID="7c523a4-7da7-4e59-b888-569fe65c535b" Command="Debit" Mode="Test">

</Transaction>

</V_XML>

</request>

  </Execute>

  </soap:Body>

  </soap: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/">

  <Transaction ApplicationID="{7C523A4-7DA7-4E59-B888-569FE65C535B}" Command="Debit" Mode="Test" RequestID="{7549E81F-016B-4A83-B136-CEAF6A7A093A}">

    <Result Status="0" Code="0" Description="" AppServer="105IVERIAPPPR1N" DBServer="105iveridbpr01n" Gateway="Nedbank" AcquirerCode="00" AcquirerDescription="" />

    <Terminal>Default</Terminal>

    <MerchantName>iVeri Payment Technology</MerchantName>

    <Acquirer>NBPostilionNBSouthAfrica</Acquirer>

    <CardType>Unknown CardType</CardType>

    <Issuer>Unknown Issuer</Issuer>

    <Jurisdiction>International</Jurisdiction>

    <PANMode>Keyed</PANMode>

    <CardHolderPresence>CardNotPresent</CardHolderPresence>

    <MerchantAddress>MERCHANT ADDRESS</MerchantAddress>

    <MerchantCity>Sandton</MerchantCity>

    <MerchantCountry>South Africa</MerchantCountry>

    <DistributorName>Nedbank</DistributorName>

  </Transaction>

</V_XML></ExecuteResult>

        </ExecuteResponse>

    </soap:Body>

</soap:Envelope>

Pre-Auth Reversal – Authorisation Reversal

Allows merchants to submit an instruction to cancel/reverse a pre-authorized amount on the cardholder’s card

REST

Request

{

    "Version": "2.0",

    "CertificateID": "{5c4b9c74-0063-4240-9cff-f730675c5bd0}",

    "ProductType": "Enterprise",

    "ProductVersion": "WebAPI",

    "Direction": "Request",

    "Transaction": {

        "ApplicationID": "{8d5a94-8fa0-428d-a539-3a5baf166f7f}",

        "Command": "AuthorisationReversal",

        "Mode": "Test",

        "TransactionIndex": "{34799783-6A61-4EFB-8E1C-DA3D73C27F05}"

    }

Response

{

    "Version": "2.0",

    "Direction": "Response",

    "Transaction": {

        "Amount": "3000",

        "AuthorisationCode": "551260",

        "CCNumber": "4242........4242",

        "Currency": "ZAR",

        "ExpiryDate": "102025",

        "MerchantReference": "20221108_1242",

        "Terminal": "Default",

        "TransactionIndex": "{34799783-6A61-4EFB-8E1C-DA3D73C27F05}",

        "MerchantName": "iVeri Payment Technology",

        "MerchantUSN": "7771777",

        "Acquirer": "NBPostilionNBSouthAfrica",

        "AcquirerReference": "95702:04641695",

        "AcquirerDate": "20221229",

        "AcquirerTime": "124130",

        "DisplayAmount": "R 30.00",

        "BIN": "4",

        "Association": "VISA",

        "CardType": "Unknown CardType",

        "Issuer": "Unknown Issuer",

        "Jurisdiction": "International",

        "PAN": "4242........4242",

        "PANMode": "Keyed",

        "ReconReference": "04641695",

        "CardHolderPresence": "CardNotPresent",

        "MerchantAddress": "MERCHANT ADDRESS",

        "MerchantCity": "Sandton",

        "MerchantCountryCode": "ZA",

        "MerchantCountry": "South Africa",

        "DistributorName": "Nedbank",

        "ApplicationID": "{8D5A94-8FA0-428D-A539-3A5BAF166F7F}",

        "Command": "AuthorisationReversal",

        "Mode": "Test",

        "RequestID": "{2D4A81AB-2214-4983-A9EA-933AF9E04612}",

        "Result": {

            "Status": "0",

            "Code": "0",

            "Description": "",

            "AppServer": "105IVERIAPPPR1N",

            "DBServer": "105iveridbpr01n",

            "Gateway": "Nedbank",

            "AcquirerCode": "00",

            "AcquirerDescription": ""

        }

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/">

  <soap:Body>

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

  <validateRequest>false</validateRequest>

    <V_XML Version="2.0" CertificateID="cf4b7e7a-4fec-43b4-a2cb-221263c0a34b" 

    ProductType="Enterprise" ProductVersion="iVeriWebService" Direction="Request">

    <Transaction ApplicationID="7c523a4-7da7-4e59-b888-569fe65c535b" Command="AuthorisationReversal" Mode="Test">

    </Transaction></V_XML>

</request>

  </Execute>

  </soap:Body>

  </soap: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/">

  <Transaction ApplicationID="{7C523A4-7DA7-4E59-B888-569FE65C535B}" Command="AuthorisationReversal" Mode="Test" RequestID="{6ED66FD3-6F77-48A4-9CF7-80CB8E8DE50F}">

    <Result Status="0" Code="0" Description="" AppServer="105IVERIAPPPR2N" DBServer="105iveridbpr01n" Gateway="Nedbank" AcquirerCode="00" AcquirerDescription="" />

    <Terminal>Default</Terminal>

    <MerchantName>iVeri Payment Technology</MerchantName>

    <Acquirer>NBPostilionNBSouthAfrica</Acquirer>

    <CardType>Unknown CardType</CardType>

    <Issuer>Unknown Issuer</Issuer>

    <Jurisdiction>International</Jurisdiction>

    <PANMode>Keyed</PANMode>

    <CardHolderPresence>CardNotPresent</CardHolderPresence>

    <MerchantAddress>MERCHANT ADDRESS</MerchantAddress>

    <MerchantCity>Sandton</MerchantCity>

    <MerchantCountry>South Africa</MerchantCountry>

    <DistributorName>Nedbank</DistributorName>

  </Transaction>

</V_XML></ExecuteResult>

        </ExecuteResponse>

    </soap:Body>

</soap:Envelope>

Refund – Follow-Credit

Allows for a previously debited amount to be returned to the cardholders account using a detail of a previously processed transaction.

REST

Request

{

    "Version": "2.0",

    "CertificateID": "{5c4b9c74-0063-4240-9cff-f730675c5bd0}",

    "ProductType": "Enterprise",

    "ProductVersion": "WebAPI",

    "Direction": "Request",

    "Transaction": {

        "ApplicationID": "{d8d5a94-8fa0-428d-a539-3a5baf166f7f}",

        "Command": "Credit",

        "Mode": "Test",

        "Amount": "1000",

        "MerchantTrace":"20220812_1107",

        "MerchantReference": "20221123_1106",

        "TransactionIndex": "{CB7A9E38-4797-4513-85EE-AFE63C957ED3}"

    }

Response

{

    "Version": "2.0",

    "Direction": "Response",

    "Transaction": {

        "MerchantTrace": "20220812_1107",

        "Amount": "1000",

        "AuthorisationCode": "545684",

        "CCNumber": "4242........4242",

        "Currency": "ZAR",

        "ExpiryDate": "102025",

        "MerchantReference": "20221123_1106",

        "Terminal": "Default",

        "TransactionIndex": "{CB7A9E38-4797-4513-85EE-AFE63C957ED3}",

        "MerchantName": "iVeri Payment Technology",

        "MerchantUSN": "7771777",

        "Acquirer": "NBPostilionNBSouthAfrica",

        "AcquirerReference": "95702:04641688",

        "AcquirerDate": "20221229",

        "AcquirerTime": "110804",

        "DisplayAmount": "R 10.00",

        "BIN": "4",

        "Association": "VISA",

        "CardType": "Unknown CardType",

        "Issuer": "Unknown Issuer",

        "Jurisdiction": "International",

        "PAN": "4242........4242",

        "PANMode": "",

        "ReconReference": "04641688",

        "CardHolderPresence": "CardNotPresent",

        "MerchantAddress": "MERCHANT ADDRESS",

        "MerchantCity": "Sandton",

        "MerchantCountryCode": "ZA",

        "MerchantCountry": "South Africa",

        "DistributorName": "Nedbank",

        "ApplicationID": "{D8D5A94-8FA0-428D-A539-3A5BAF166F7F}",

        "Command": "Credit",

        "Mode": "Test",

        "RequestID": "{A8BCFF58-C35B-40ED-8F5D-01FFFA14FD19}",

        "Result": {

            "Status": "0",

            "Code": "0",

            "Description": "",

            "AppServer": "105IVERIAPPPR2N",

            "DBServer": "105iveridbpr01n",

            "Gateway": "Nedbank",

            "AcquirerCode": "00",

            "AcquirerDescription": ""

        }

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/">

  <soap:Body>

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

  <validateRequest>false</validateRequest>

  <request><V_XML Version="2.0" CertificateID="cf4b7e7a-4fec-43b4-a2cb-221263c0a34b" ProductType="Enterprise"

ProductVersion="iVeriWebService" Direction="Request">

<Transaction ApplicationID="7c523a4-7da7-4e59-b888-569fe65c535b" Command="Credit" Mode="Test">

</Transaction>

</V_XML>

</request>

  </Execute>

  </soap:Body>

  </soap: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/">

  <Transaction ApplicationID="{7C523A4-7DA7-4E59-B888-569FE65C535B}" Command="Credit" Mode="Test" RequestID="{1EDD5EF7-D27C-4D68-95FA-7627E42AFE6E}">

    <Result Status="0" Code="0" Description="" AppServer="105IVERIAPPPR2N" DBServer="105iveridbpr01n" Gateway="Nedbank" AcquirerCode="00" AcquirerDescription="" />

    <Terminal>Default</Terminal>

    <MerchantName>iVeri Payment Technology</MerchantName>

    <Acquirer>NBPostilionNBSouthAfrica</Acquirer>

    <CardType>Unknown CardType</CardType>

    <Issuer>Unknown Issuer</Issuer>

    <Jurisdiction>International</Jurisdiction>

    <PANMode />

    <CardHolderPresence>CardNotPresent</CardHolderPresence>

    <MerchantAddress>MERCHANT ADDRESS</MerchantAddress>

    <MerchantCity>Sandton</MerchantCity>

    <MerchantCountry>South Africa</MerchantCountry>

    <DistributorName>Nedbank</DistributorName>

  </Transaction>

</V_XML></ExecuteResult>

        </ExecuteResponse>

    </soap:Body>

</soap:Envelope>

Refund – Initial Credit

Allows the merchants to essentially “pay” or “credit” the cardholder without referencing any original or previously processed transaction

REST

Request

{

    "Version": "2.0",

    "CertificateID": "{cf4b7e7a-4fec-43b4-a2cb-221263c0a34b}",

    "ProductType": "Enterprise",

    "ProductVersion": "WebAPI",

    "Direction": "Request",

    "Transaction": {

        "ApplicationID": "e7c523a4-7da7-4e59-b888-569fe65c535b",

        "Command": "Credit",

        "Mode": "TEST",

        "MerchantReference": "20211014_0129",

        "MerchantTrace": "NAHSI-1112",

        "Currency": "ZAR", 

        "Amount": "1000",

        "ExpiryDate": "1025",

        "PAN": "4242424242424242"

    }

Response

{

    "Version": "2.0",

    "Direction": "Response",

    "Transaction": {

        "MerchantTrace": "NAHSI-1112",

        "Amount": "1000",

        "AuthorisationCode": "550310",

        "CCNumber": "4242........4242",

        "Currency": "ZAR",

        "ExpiryDate": "102025",

        "MerchantReference": "20211014_0129",

        "Terminal": "Default",

        "TransactionIndex": "{B1BF566A-23FE-43A4-A5A0-DBF648C1D94F}",

        "MerchantName": "iVeri Payment Technology",

        "MerchantUSN": "7771777",

        "Acquirer": "NBPostilionNBSouthAfrica",

        "AcquirerReference": "95702:04641691",

        "AcquirerDate": "20221229",

        "AcquirerTime": "122510",

        "DisplayAmount": "R 10.00",

        "BIN": "4",

        "Association": "VISA",

        "CardType": "Unknown CardType",

        "Issuer": "Unknown Issuer",

        "Jurisdiction": "International",

        "PAN": "4242........4242",

        "PANMode": "Keyed",

        "ReconReference": "04641691",

        "CardHolderPresence": "CardNotPresent",

        "MerchantAddress": "MERCHANT ADDRESS",

        "MerchantCity": "Sandton",

        "MerchantCountryCode": "ZA",

        "MerchantCountry": "South Africa",

        "DistributorName": "Nedbank",

        "ApplicationID": "{E7C523A4-7DA7-4E59-B888-569FE65C535B}",

        "Command": "Credit",

        "Mode": "Test",

        "RequestID": "{61F85F10-5E7B-40C8-A18C-DD1EE595665D}",

        "Result": {

            "Status": "0",

            "Code": "0",

            "Description": "",

            "AppServer": "105IVERIAPPPR1N",

            "DBServer": "105iveridbpr01n",

            "Gateway": "Nedbank",

            "AcquirerCode": "00",

            "AcquirerDescription": ""

        }

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/">

  <soap:Body>

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

  <validateRequest>false</validateRequest>

    <V_XML Version="2.0" CertificateID="cf4b7e7a-4fec-43b4-a2cb-221263c0a34b" 

    ProductType="Enterprise" ProductVersion="iVeriWebService" Direction="Request">

    <Transaction ApplicationID="e7c523a4-7da7-4e59-b888-569fe65c535b" Command="Credit" Mode="Test">

    </Transaction></V_XML>

</request>

  </Execute>

  </soap:Body>

  </soap: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/">

    <Result Status="0" Code="0" Description="" AppServer="105IVERIAPPPR2N" DBServer="105iveridbpr01n" Gateway="Nedbank" AcquirerCode="00" AcquirerDescription="" />

    <Terminal>Default</Terminal>

    <MerchantName>iVeri Payment Technology</MerchantName>

    <Acquirer>NBPostilionNBSouthAfrica</Acquirer>

    <CardType>Unknown CardType</CardType>

    <Issuer>Unknown Issuer</Issuer>

    <Jurisdiction>International</Jurisdiction>

    <PANMode>Keyed</PANMode>

    <CardHolderPresence>CardNotPresent</CardHolderPresence>

    <MerchantAddress>MERCHANT ADDRESS</MerchantAddress>

    <MerchantCity>Sandton</MerchantCity>

    <MerchantCountry>South Africa</MerchantCountry>

    <DistributorName>Nedbank</DistributorName>

  </Transaction>

</V_XML></ExecuteResult>

        </ExecuteResponse>

    </soap:Body>

</soap:Envelope>

Void

Void should be performed on an event where transactions are not responded to or not completed to the merchant’s application which could be due to a timeout scenario. When used the void message should be performed closer to the time it relates. For more on the use of Void messages, refer to the Ensuring end to end Transaction Integrity

REST

Request

{

    "Version": "2.0",

    "CertificateID": "{5c4b9c74-0063-4240-9cff-f730675c5bd0}",

    "ProductType": "Enterprise",

    "ProductVersion": "WebAPI",

    "Direction": "Request",

    "Transaction": {

        "ApplicationID": "{d8d5a94-8fa0-428d-a539-3a5baf166f7f}",

        "Command": "Void",

        "Mode": "Test",

        "OriginalMerchantTrace": "DIAAAY22734",

        "OriginalRequestID": "{9667792F-635A-4121-AC85-E06856ADC3EF}"

    }

Response

{

    "Version": "2.0",

    "Direction": "Response",

    "Transaction": {

        "OriginalMerchantTrace": "DIAAAY22734",

        "OriginalRequestID": "{9667792F-635A-4121-AC85-E06856ADC3EF}",

        "ApplicationID": "{D8D5A94-8FA0-428D-A539-3A5BAF166F7F}",

        "Command": "Void",

        "Mode": "Test",

        "RequestID": "{F096A71F-75D0-4F0C-A150-0AF181A86445}",

        "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/">

  <soap:Body>

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

  <validateRequest>false</validateRequest>

    <V_XML Version="2.0" CertificateID="cf4b7e7a-4fec-43b4-a2cb-221263c0a34b" 

    ProductType="Enterprise" ProductVersion="iVeriWebService" Direction="Request">

    <Transaction ApplicationID="7c523a4-7da7-4e59-b888-569fe65c535b" Command="Void" Mode="Test">

    </Transaction></V_XML>

</request>

  </Execute>

  </soap:Body>

  </soap: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/">

  <Transaction ApplicationID="{7C523A4-7DA7-4E59-B888-569FE65C535B}" Command="Void" Mode="Test" RequestID="{2EDCA6EC-0683-41C2-872B-CC5A01355EFD}">

    <Result Status="0" Code="0" Description="" AppServer="105IVERIAPPPR2N" DBServer="105iveridbpr01n" Gateway="Nedbank" />

  </Transaction>

</V_XML></ExecuteResult>

        </ExecuteResponse>

    </soap:Body>

</soap:Envelope>

Account Validation

REST

Request
{
"Version": "2.0",
"CertificateID": "{de3022ce-15a2-4702-a46b-cc9710463135}",
"ProductType": "Enterprise",
"ProductVersion": "WebAPI",
"Direction": "Request",
"Enquiry": {
"ApplicationID": "{32087932-7927-445b-9a26-106e92b246ba}",
"Command": "AccountValidation",
//"MerchantReference":"Test-123",
"Mode": "TEST",
"PAN": "5192602720584796",
"ExpiryDate": "1025",

}
}

Response
{
"Version": "2.0",
"Direction": "Response",
"Enquiry": {
"MerchantName": "iVeri Payment Technology",
"MerchantUSN": "7771777",
"Acquirer": "NBPostilionNBSouthAfrica",
"AcquirerReference": "96655:05360721",
"AcquirerDate": "20250808",
"AcquirerTime": "102319",
"MerchantAddress": "Santon",
"MerchantCity": "MERCHANT CITY",
"MerchantCountryCode": "ZA",
"MerchantCountry": "South Africa",
"DistributorName": "Nedbank",
"ApplicationID": "{32087932-7927-445B-9A26-106E92B246BA}",
"Command": "Balance",
"Mode": "Test",
"RequestID": "{B8C207FB-95EF-4190-A478-3E9B61E78F17}",
"Result": {
"Status": "0",
"Code": "0",
"Description": "",
"AppServer": "105IVERIAPPPR1N",
"DBServer": "105iveridbpr01n",
"Gateway": "Nedbank",
"AcquirerCode": "00",
"AcquirerDescription": ""
}
}
}