- KnowSystem
- Transaction Message Examples
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 SOAP and REST API
Further insights on the transaction types and their meanings, can be referenced on 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 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
Payment instruction using full card details, and where the cardholder is debited, and merchant account is credited
REST
{
"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"
}
}
{
"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
<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>
<protocol>V_XML</protocol>
<protocolVersion>7.0</protocolVersion>
<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">
<MerchantTrace>2407E27568BEEE</MerchantTrace>
<Amount>2000</Amount>
<Currency>ZAR</Currency>
<ExpiryDate>042024</ExpiryDate>
<MerchantReference>20220104.0942</MerchantReference>
<CardSecurityCode>183</CardSecurityCode>
<PAN>4242424242424242</PAN>
</Transaction></V_XML>
</request>
</Execute>
</soap:Body>
</soap:Envelope>
<?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><V_XML Version="2.0" Direction="Response"> <Transaction ApplicationID="{7C523A4-7DA7-4E59-B888-569FE65C535B}" Command="Debit" Mode="Test" RequestID="{E01B8439-05B0-4B68-A22F-903D8CB5CC67}">
<Result Status="0" Code="0" Description="" AppServer="105IVERIAPPPR1N" DBServer="105iveridbpr01n" Gateway="Nedbank" AcquirerCode="00" AcquirerDescription="" />
<MerchantTrace>2407E27568BEEE</MerchantTrace>
<Amount>2000</Amount>
<AuthorisationCode>540565</AuthorisationCode>
<CCNumber>4242........4242</CCNumber>
<Currency>ZAR</Currency>
<ExpiryDate>042024</ExpiryDate>
<MerchantReference>20220104.0942</MerchantReference>
<Terminal>Default</Terminal>
<TransactionIndex>{F20B545A-B2CC-40E9-8C9B-40030AC50B31}</TransactionIndex>
<MerchantName>iVeri Payment Technology</MerchantName>
<MerchantUSN>7771777</MerchantUSN>
<Acquirer>NBPostilionNBSouthAfrica</Acquirer>
<AcquirerReference>95702:04641678</AcquirerReference>
<AcquirerDate>20221229</AcquirerDate>
<AcquirerTime>094245</AcquirerTime>
<DisplayAmount>R 20.00</DisplayAmount>
<BIN>4</BIN>
<Association>VISA</Association>
<CardType>Unknown CardType</CardType>
<Issuer>Unknown Issuer</Issuer>
<Jurisdiction>International</Jurisdiction>
<PAN>4242........4242</PAN>
<PANMode>Keyed</PANMode>
<ReconReference>04641678</ReconReference>
<CardHolderPresence>CardNotPresent</CardHolderPresence>
<MerchantAddress>MERCHANT ADDRESS</MerchantAddress>
<MerchantCity>Sandton</MerchantCity>
<MerchantCountryCode>ZA</MerchantCountryCode>
<MerchantCountry>South Africa</MerchantCountry>
<DistributorName>Nedbank</DistributorName>
</Transaction>
</V_XML></ExecuteResult>
</ExecuteResponse>
</soap:Body>
</soap:Envelope>
Sale – Debit with Transaction Index
Payment instruction using tokenised data to debit the cardholder, and where the merchant account is credited
REST
{
"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}",
}
}
{
"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 using card details
REST
{
"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"
}
}
{
"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
<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>
<protocol>V_XML</protocol>
<protocolVersion>7.0</protocolVersion>
<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="Authorisation" Mode="Test">
<MerchantTrace>2407E27568ABEEE</MerchantTrace>
<Amount>1000</Amount>
<Currency>ZAR</Currency>
<ExpiryDate>042024</ExpiryDate>
<MerchantReference>20220104.1051</MerchantReference>
<PAN>4242424242424242</PAN>
</Transaction></V_XML>
</request>
</Execute>
</soap:Body>
</soap:Envelope>
<?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><V_XML Version="2.0" Direction="Response"> <Transaction ApplicationID="{7C523A4-7DA7-4E59-B888-569FE65C535B}" Command="Authorisation" Mode="Test" RequestID="{E7134374-BC00-428E-9F32-AE5DED439EEF}">
<Result Status="0" Code="0" Description="" AppServer="105IVERIAPPPR2N" DBServer="105iveridbpr01n" Gateway="Nedbank" AcquirerCode="00" AcquirerDescription="" />
<MerchantTrace>2407E27568ABEEE</MerchantTrace>
<Amount>1000</Amount>
<AuthorisationCode>544721</AuthorisationCode>
<CCNumber>4242........4242</CCNumber>
<Currency>ZAR</Currency>
<ExpiryDate>042024</ExpiryDate>
<MerchantReference>20220104.1051</MerchantReference>
<Terminal>Default</Terminal>
<TransactionIndex>{1D638328-7A15-4937-9818-C3F9C9B96E52}</TransactionIndex>
<MerchantName>iVeri Payment Technology</MerchantName>
<MerchantUSN>7771777</MerchantUSN>
<Acquirer>NBPostilionNBSouthAfrica</Acquirer>
<AcquirerReference>95702:04641686</AcquirerReference>
<AcquirerDate>20221229</AcquirerDate>
<AcquirerTime>105201</AcquirerTime>
<DisplayAmount>R 10.00</DisplayAmount>
<BIN>4</BIN>
<Association>VISA</Association>
<CardType>Unknown CardType</CardType>
<Issuer>Unknown Issuer</Issuer>
<Jurisdiction>International</Jurisdiction>
<PAN>4242........4242</PAN>
<PANMode>Keyed</PANMode>
<ReconReference>04641686</ReconReference>
<CardHolderPresence>CardNotPresent</CardHolderPresence>
<MerchantAddress>MERCHANT ADDRESS</MerchantAddress>
<MerchantCity>Sandton</MerchantCity>
<MerchantCountryCode>ZA</MerchantCountryCode>
<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
{
"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}"
}
}
{
"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
<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>
<protocol>V_XML</protocol>
<protocolVersion>7.0</protocolVersion>
<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">
<MerchantTrace>9AE405C07E7)7568BEEE</MerchantTrace>
<Amount>1000</Amount>
<MerchantReference>20220104.1057</MerchantReference>
<TransactionIndex>{1D638328-7A15-4937-9818-C3F9C9B96E52}</TransactionIndex>
</Transaction>
</V_XML>
</request>
</Execute>
</soap:Body>
</soap:Envelope>
<?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><V_XML Version="2.0" Direction="Response">
<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="" />
<MerchantTrace>9AE405C07E7)7568BEEE</MerchantTrace>
<Amount>1000</Amount>
<AuthorisationCode>545108</AuthorisationCode>
<CCNumber>4242........4242</CCNumber>
<Currency>ZAR</Currency>
<ExpiryDate>042024</ExpiryDate>
<MerchantReference>20220104.1057</MerchantReference>
<Terminal>Default</Terminal>
<TransactionIndex>{1D638328-7A15-4937-9818-C3F9C9B96E52}</TransactionIndex>
<MerchantName>iVeri Payment Technology</MerchantName>
<MerchantUSN>7771777</MerchantUSN>
<Acquirer>NBPostilionNBSouthAfrica</Acquirer>
<AcquirerReference>95702:04641686</AcquirerReference>
<AcquirerDate>20221229</AcquirerDate>
<AcquirerTime>105828</AcquirerTime>
<DisplayAmount>R 10.00</DisplayAmount>
<BIN>4</BIN>
<Association>VISA</Association>
<CardType>Unknown CardType</CardType>
<Issuer>Unknown Issuer</Issuer>
<Jurisdiction>International</Jurisdiction>
<PAN>4242........4242</PAN>
<PANMode>Keyed</PANMode>
<ReconReference>04641686</ReconReference>
<CardHolderPresence>CardNotPresent</CardHolderPresence>
<MerchantAddress>MERCHANT ADDRESS</MerchantAddress>
<MerchantCity>Sandton</MerchantCity>
<MerchantCountryCode>ZA</MerchantCountryCode>
<MerchantCountry>South Africa</MerchantCountry>
<DistributorName>Nedbank</DistributorName>
</Transaction>
</V_XML></ExecuteResult>
</ExecuteResponse>
</soap:Body>
</soap:Envelope>
Pre-Auth Reversal – AuthorisationReversal
Allows merchants to submit an instruction to cancel/reverse a pre-authorized amount on the cardholder’s card
REST
{
"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}"
}
}
{
"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
<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>
<protocol>V_XML</protocol>
<protocolVersion>7.0</protocolVersion>
<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="AuthorisationReversal" Mode="Test">
<TransactionIndex>{258A91D9-2B0B-4445-ADB2-E5DF210E9054}</TransactionIndex>
</Transaction></V_XML>
</request>
</Execute>
</soap:Body>
</soap:Envelope>
<?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><V_XML Version="2.0" Direction="Response">
<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="" />
<Amount>1000</Amount>
<AuthorisationCode>551388</AuthorisationCode>
<CCNumber>4242........4242</CCNumber>
<Currency>ZAR</Currency>
<ExpiryDate>042024</ExpiryDate>
<MerchantReference>20220104.1251</MerchantReference>
<Terminal>Default</Terminal>
<TransactionIndex>{258A91D9-2B0B-4445-ADB2-E5DF210E9054}</TransactionIndex>
<MerchantName>iVeri Payment Technology</MerchantName>
<MerchantUSN>7771777</MerchantUSN>
<Acquirer>NBPostilionNBSouthAfrica</Acquirer>
<AcquirerReference>95702:04641696</AcquirerReference>
<AcquirerDate>20221229</AcquirerDate>
<AcquirerTime>125040</AcquirerTime>
<DisplayAmount>R 10.00</DisplayAmount>
<BIN>4</BIN>
<Association>VISA</Association>
<CardType>Unknown CardType</CardType>
<Issuer>Unknown Issuer</Issuer>
<Jurisdiction>International</Jurisdiction>
<PAN>4242........4242</PAN>
<PANMode>Keyed</PANMode>
<ReconReference>04641696</ReconReference>
<CardHolderPresence>CardNotPresent</CardHolderPresence>
<MerchantAddress>MERCHANT ADDRESS</MerchantAddress>
<MerchantCity>Sandton</MerchantCity>
<MerchantCountryCode>ZA</MerchantCountryCode>
<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
{
"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}"
}
}
{
"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
<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>
<protocol>V_XML</protocol>
<protocolVersion>7.0</protocolVersion>
<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">
<MerchantTrace>9AE405C07E7227568BEEE</MerchantTrace>
<Amount>2000</Amount>
<MerchantReference>20220104.0942</MerchantReference>
<TransactionIndex>{F20B545A-B2CC-40E9-8C9B-40030AC50B31}</TransactionIndex>
</Transaction>
</V_XML>
</request>
</Execute>
</soap:Body>
</soap:Envelope>
<?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><V_XML Version="2.0" Direction="Response">
<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="" />
<MerchantTrace>9AE405C07E7227568BEEE</MerchantTrace>
<Amount>2000</Amount>
<AuthorisationCode>541742</AuthorisationCode>
<CCNumber>4242........4242</CCNumber>
<Currency>ZAR</Currency>
<ExpiryDate>042024</ExpiryDate>
<MerchantReference>20220104.0942</MerchantReference>
<Terminal>Default</Terminal>
<TransactionIndex>{F20B545A-B2CC-40E9-8C9B-40030AC50B31}</TransactionIndex>
<MerchantName>iVeri Payment Technology</MerchantName>
<MerchantUSN>7771777</MerchantUSN>
<Acquirer>NBPostilionNBSouthAfrica</Acquirer>
<AcquirerReference>95702:04641681</AcquirerReference>
<AcquirerDate>20221229</AcquirerDate>
<AcquirerTime>100222</AcquirerTime>
<DisplayAmount>R 20.00</DisplayAmount>
<BIN>4</BIN>
<Association>VISA</Association>
<CardType>Unknown CardType</CardType>
<Issuer>Unknown Issuer</Issuer>
<Jurisdiction>International</Jurisdiction>
<PAN>4242........4242</PAN>
<PANMode />
<ReconReference>04641681</ReconReference>
<CardHolderPresence>CardNotPresent</CardHolderPresence>
<MerchantAddress>MERCHANT ADDRESS</MerchantAddress>
<MerchantCity>Sandton</MerchantCity>
<MerchantCountryCode>ZA</MerchantCountryCode>
<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
{
"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"
}
}
{
"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
<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>
<protocol>V_XML</protocol>
<protocolVersion>7.0</protocolVersion>
<request>
<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">
<MerchantTrace>2407E295EEE</MerchantTrace>
<Amount>1000</Amount>
<Currency>ZAR</Currency>
<ExpiryDate>042024</ExpiryDate>
<MerchantReference>20220104.1213</MerchantReference>
<CardSecurityCode>183</CardSecurityCode>
<PAN>4242424242424242</PAN>
</Transaction></V_XML>
</request>
</Execute>
</soap:Body>
</soap:Envelope>
<?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><V_XML Version="2.0" Direction="Response"> <Transaction ApplicationID="{E7C523A4-7DA7-4E59-B888-569FE65C535B}" Command="Credit" Mode="Test" RequestID="{69F6E0B8-BDA0-4586-8185-815F95A15FE4}">
<Result Status="0" Code="0" Description="" AppServer="105IVERIAPPPR2N" DBServer="105iveridbpr01n" Gateway="Nedbank" AcquirerCode="00" AcquirerDescription="" />
<MerchantTrace>2407E295EEE</MerchantTrace>
<Amount>1000</Amount>
<AuthorisationCode>550367</AuthorisationCode>
<CCNumber>4242........4242</CCNumber>
<Currency>ZAR</Currency>
<ExpiryDate>042024</ExpiryDate>
<MerchantReference>20220104.1213</MerchantReference>
<Terminal>Default</Terminal>
<TransactionIndex>{89CCE679-E1B1-497C-8684-C6080EB61B00}</TransactionIndex>
<MerchantName>iVeri Payment Technology</MerchantName>
<MerchantUSN>7771777</MerchantUSN>
<Acquirer>NBPostilionNBSouthAfrica</Acquirer>
<AcquirerReference>95702:04641692</AcquirerReference>
<AcquirerDate>20221229</AcquirerDate>
<AcquirerTime>122607</AcquirerTime>
<DisplayAmount>R 10.00</DisplayAmount>
<BIN>4</BIN>
<Association>VISA</Association>
<CardType>Unknown CardType</CardType>
<Issuer>Unknown Issuer</Issuer>
<Jurisdiction>International</Jurisdiction>
<PAN>4242........4242</PAN>
<PANMode>Keyed</PANMode>
<ReconReference>04641692</ReconReference>
<CardHolderPresence>CardNotPresent</CardHolderPresence>
<MerchantAddress>MERCHANT ADDRESS</MerchantAddress>
<MerchantCity>Sandton</MerchantCity>
<MerchantCountryCode>ZA</MerchantCountryCode>
<MerchantCountry>South Africa</MerchantCountry>
<DistributorName>Nedbank</DistributorName>
</Transaction>
</V_XML></ExecuteResult>
</ExecuteResponse>
</soap:Body>
</soap:Envelope>
Transaction Status by Original Merchant Reference
Used to query the transaction status using an original merchant reference number
REST
{
"Version": "2.0",
"CertificateID": "{DE3022CE-15A2-4702-A46B-CC9710463135}",
"ProductType": "Enterprise",
"Direction": "Request",
"Enquiry": {
"ApplicationID": "{851282c8-194c-42da-a09b-333160959e39}",
"Command": "TransactionStatus",
"Mode": "TEST",
"OriginalMerchantReference":"202507.01"
}
}
{
"Version": "2.0",
"Direction": "Response",
"Enquiry": {
"OriginalMerchantReference": "202507.01",
"TransactionStatus": {
"DeviceSerialNumber": "",
"MerchantTrace": "2025.001",
"Amount": "10000",
"AuthorisationCode": "",
"BudgetPeriod": "0",
"CCNumber": "4895........9709",
"Currency": "ZAR",
"ExpiryDate": "092029",
"MerchantReference": "202507.01",
"Terminal": "Default",
"TransactionIndex": "2637cd71-c306-4934-a4fb-741183f4ccec",
"MerchantUSN": "7771777",
"Acquirer": "NBPostilionNBSouthAfrica",
"AcquirerReference": "96674:05371761",
"AcquirerDate": "20250827",
"AcquirerTime": "103040",
"DisplayAmount": "R 100.00",
"BIN": "48957491",
"PAN": "4895........9709",
"PANMode": "Keyed",
"ReconReference": "05371761",
"ApplicationID": "851282c8-194c-42da-a09b-333160959e39",
"Command": "Debit",
"RequestID": "12118735-e7c3-48a8-a4ea-7f9de587b2d1",
"Result": {
"Status": "-1",
"Code": "255",
"Description": "General error",
"Source": "NBPostilionNBSouthAfricaTestProv",
"AppServer": "105IVERIAPPPR1N",
"DBServer": "105iveridbpr01n",
"Gateway": "Nedbank"
}
},
"ApplicationID": "{851282C8-194C-42DA-A09B-333160959E39}",
"Command": "TransactionStatus",
"Mode": "Test"
}
}Transaction Status by Original Merchant Trace
Used to query the transaction status using an original merchant trace number
REST
{
"Version": "2.0",
"CertificateID": "{DE3022CE-15A2-4702-A46B-CC9710463135}", //replace with merchant certID
"ProductType": "Enterprise",
"ProductVersion": "WebAPI",
"Direction": "Request",
"Transaction": {
"ApplicationID": "{851282c8-194c-42da-a09b-333160959e39}", //replace with merchant applicationID
"Command": "Debit",
"Mode": "Test",
"OriginalMerchantReference": "202507.01",
}
}
{
Version": "2.0",
"Direction": "Response",
"Enquiry": {
"OriginalMerchantReference": "202507.01",
"TransactionStatus": {
"DeviceSerialNumber": "",
"MerchantTrace": "2025.001",
"Amount": "10000",
"AuthorisationCode": "",
"BudgetPeriod": "0",
"CCNumber": "4895........9709",
"Currency": "ZAR",
"ExpiryDate": "092029",
"MerchantReference": "202507.01",
"Terminal": "Default",
"TransactionIndex": "2637cd71-c306-4934-a4fb-741183f4ccec",
"MerchantUSN": "7771777",
"Acquirer": "NBPostilionNBSouthAfrica",
"AcquirerReference": "96675:05372625",
"AcquirerDate": "20250828",
"AcquirerTime": "123322",
"DisplayAmount": "R 100.00",
"BIN": "48957491",
"PAN": "4895........9709",
"PANMode": "Keyed",
"ReconReference": "05372625",
"ApplicationID": "851282c8-194c-42da-a09b-333160959e39",
"Command": "Debit",
"RequestID": "1fe1ca4f-b4ed-4cc2-952b-3d106d0c5b16",
"Result": {
"Status": "0",
"Code": "0",
"Description": "",
"AppServer": "105IVERIAPPPR2N",
"DBServer": "105IVERIDBPR01N",
"Gateway": "Nedbank"
}
},
"ApplicationID": "{851282C8-194C-42DA-A09B-333160959E39}",
"Command": "TransactionStatus",
"Mode": "Test"
}
Transaction Status by Original RequestID
Used to query the transaction status using an original RequestID
REST
{
"Version": "2.0",
"CertificateID": "{DE3022CE-15A2-4702-A46B-CC9710463135}", //replace with merchant certID
"ProductType": "Enterprise",
"ProductVersion": "WebAPI",
"Direction": "Request",
"Transaction": {
"ApplicationID": "{851282c8-194c-42da-a09b-333160959e39}", //replace with merchant applicationID
"Command": "Debit",
"Mode": "Test",
"OriginalRequestID":"95537EA5-F7D4-44A2-98C1-B753528EF40F"
}
}
{
"Version": "2.0",
"Direction": "Response",
"Enquiry": {
"OriginalRequestID": "95537EA5-F7D4-44A2-98C1-B753528EF40F",
"TransactionStatus": {
"DeviceSerialNumber": "",
"MerchantTrace": "2025.001",
"Amount": "10000",
"AuthorisationCode": "542464",
"BudgetPeriod": "0",
"CCNumber": "4895........9709",
"Currency": "ZAR",
"ExpiryDate": "092029",
"MerchantReference": "202507.01",
"Terminal": "Default",
"TransactionIndex": "2637cd71-c306-4934-a4fb-741183f4ccec",
"MerchantUSN": "7771777",
"Acquirer": "NBPostilionNBSouthAfrica",
"AcquirerReference": "96676:05373287",
"AcquirerDate": "20250829",
"AcquirerTime": "101424",
"DisplayAmount": "R 100.00",
"BIN": "48957491",
"PAN": "4895........9709",
"PANMode": "Keyed",
"ReconReference": "05373287",
"ApplicationID": "851282c8-194c-42da-a09b-333160959e39",
"Command": "Debit",
"RequestID": "95537ea5-f7d4-44a2-98c1-b753528ef40f",
"Result": {
"Status": "0",
"Code": "0",
"Description": "",
"AppServer": "105IVERIAPPPR2N",
"DBServer": "105iveridbpr01n",
"Gateway": "Nedbank"
}
},
"ApplicationID": "{851282C8-194C-42DA-A09B-333160959E39}",
"Command": "TransactionStatus",
"Mode": "Test"
}
}
Transaction Status by TransactionIndex
Used to query the transaction status using an TransactionIndex
REST
{
"Version": "2.0",
"CertificateID": "{DE3022CE-15A2-4702-A46B-CC9710463135}", //replace with merchant certID
"ProductType": "Enterprise",
"ProductVersion": "WebAPI",
"Direction": "Request",
"Transaction": {
"ApplicationID": "{851282c8-194c-42da-a09b-333160959e39}", //replace with merchant applicationID
"Command": "Debit",
"Mode": "Test",
"TransactionIndex":"{2637CD71-C306-4934-A4FB-741183F4CCEC}"
}
}
{
"Version": "2.0",
"Direction": "Response",
"Enquiry": {
"TransactionIndex": "{2637CD71-C306-4934-A4FB-741183F4CCEC}",
"TransactionStatus": {
"DeviceSerialNumber": "",
"MerchantTrace": "2025.001",
"Amount": "10000",
"AuthorisationCode": "542464",
"BudgetPeriod": "0",
"CCNumber": "4895........9709",
"Currency": "ZAR",
"ExpiryDate": "092029",
"MerchantReference": "202507.01",
"Terminal": "Default",
"TransactionIndex": "2637cd71-c306-4934-a4fb-741183f4ccec",
"MerchantUSN": "7771777",
"Acquirer": "NBPostilionNBSouthAfrica",
"AcquirerReference": "96676:05373287",
"AcquirerDate": "20250829",
"AcquirerTime": "101424",
"DisplayAmount": "R 100.00",
"BIN": "48957491",
"PAN": "4895........9709",
"PANMode": "Keyed",
"ReconReference": "05373287",
"ApplicationID": "851282c8-194c-42da-a09b-333160959e39",
"Command": "Debit",
"RequestID": "95537ea5-f7d4-44a2-98c1-b753528ef40f",
"Result": {
"Status": "0",
"Code": "0",
"Description": "",
"AppServer": "105IVERIAPPPR2N",
"DBServer": "105iveridbpr01n",
"Gateway": "Nedbank"
}
},
"ApplicationID": "{851282C8-194C-42DA-A09B-333160959E39}",
"Command": "TransactionStatus",
"Mode": "Test"
}
}
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
{
"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}"
}
}
{
"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
<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>
<protocol>V_XML</protocol>
<protocolVersion>7.0</protocolVersion>
<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="Void" Mode="Test">
<MerchantTrace>240X568BEEE</MerchantTrace>
<OriginalRequestID>{B3C46039-5B4D-402A-82A7-A37BC0161167}</OriginalRequestID>
</Transaction></V_XML>
</request>
</Execute>
</soap:Body>
</soap:Envelope>
<?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><V_XML Version="2.0" Direction="Response">
<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" />
<OriginalMerchantTrace>240X568BEEE</OriginalMerchantTrace>
<OriginalRequestID>{B3C46039-5B4D-402A-82A7-A37BC0161167}</OriginalRequestID>
</Transaction>
</V_XML></ExecuteResult>
</ExecuteResponse>
</soap:Body>
</soap:Envelope>
Enquiry Message Examples
Account Validation
Validate the cardholders account
REST
{
"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",
}
}
{
"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": ""
}
}
}
PANToken
JSON
Request
{
"Version": "2.0",
"CertificateID": "{DE3022CE-15A2-4702-A46B-CC9710463135}", // replace with merchant certID
"ProductType": "Enterprise",
"ProductVersion": "WebAPI",
"Direction": "Request",
"Enquiry": {
"ApplicationID": "{851282c8-194c-42da-a09b-333160959e39}", //replace with merchant appID
"Command": "PANToken",
"Mode": "Test",
"Amount": "10000",
"ExpiryDate": "0929",
"PAN": "4895749143709709"
}
}
{
"Version": "2.0",
"Direction": "Response",
"Enquiry": {
"ExpiryDate": "092029",
"PAN": "4895........9709",
"BIN": "48957491",
"TransactionIndex": "{2364F192-A49D-4BCB-825A-9D98FEC073DB}",
"ApplicationID": "{851282C8-194C-42DA-A09B-333160959E39}",
"Command": "PANToken",
"Mode": "Test",
"RequestID": "{21337135-2100-49CC-8032-C15971CA0952}",
"Result": {
"Status": "0",
"Code": "0",
"Description": "",
"AppServer": "105IVERIAPPPR2N",
"DBServer": "105iveridbpr01n",
"Gateway": "Host"
}
}
}