Sample – DCC/MCP Request with Specified PAN and Base Amount

 

REST

SOAP

Request

{

    "Version""2.0",

    "CertificateID""{4c96973f-71dd-4044-802d-6e234effe8f2}",

    "ProductType""Enterprise",

    "ProductVersion""WebAPI",

    "Direction""Request",

    "Enquiry": {

        "ApplicationID""{56cdf444-b238-4609-9137-148a34b08f59}",

        "Command""DynamicCurrencyConversion",

        "Mode""LIVE",

        "MerchantReference""Farm_1709",

        "MerchantTrace""20220520_1706",

        "Currency""ZAR",

        "Amount""5000",

        "ExpiryDate""1225",

        "CardSecurityCode""001",

        "PAN""5185520050000010"

    }

}

 

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

    &lt;V_XML Version="2.0" CertificateID="{4c96973f-71dd-4044-802d-6e234effe8f2}" 

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

    &lt;Enquiry ApplicationID="{56cdf444-b238-4609-9137-148a34b08f59}" Command="DynamicCurrencyConversion" Mode="Live"&gt;

    &lt;MerchantTrace&gt;240X568VFEEE&lt;/MerchantTrace&gt;

    &lt;Amount&gt;2000&lt;/Amount&gt;

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

    &lt;ExpiryDate&gt;1225&lt;/ExpiryDate&gt;

    &lt;MerchantReference&gt;20220104.1525&lt;/MerchantReference&gt;

    &lt;CardSecurityCode&gt;001&lt;/CardSecurityCode&gt;

    &lt;PAN&gt;5185520050000010&lt;/PAN&gt;

    &lt;/Enquiry&gt;&lt;/V_XML&gt;

</request>

  </Execute>

  </soap:Body>

  </soap:Envelope>

 

Response

{

    "Version""2.0",

    "Direction""Response",

    "Enquiry": {

        "MerchantName""Busiswa",

        "MerchantUSN""1732460",

        "Acquirer""NBPostilionNBSouthAfrica",

        "AcquirerReference""02848:09021748",

        "AcquirerDate""20221230",

        "AcquirerTime""151154",

        "Currency""ZAR",

        "Amount""5000",

        "MerchantAddress""MERCHANT ADDRESS",

        "MerchantCity""Sandton",

        "MerchantCountryCode""ZA",

        "MerchantCountry""South Africa",

        "DistributorName""Nedbank",

        "ForeignExchange": {

            "ForeignExchangeItem": [

                {

                    "Version""1.0",

                    "ForeignExchangeID""{3056511A-360E-4C57-8437-4BEBE5CF0CD4}",

                    "ForeignExchangeProvider""Fexco",

                    "BaseCurrency""ZAR",

                    "BaseAmount""50.00",

                    "ForeignCurrency""KES",

                    "ForeignAmount""405.29",

                    "ExchangeRate""8.1058",

                    "ExpiryDateTime""2023-12-30 15:10:21",

                    "MarginPercentage""3.5",

                    "CommissionPercentage""0.000000",

                    "Source""REUTERS WHOLESALE INTERBANK",

                    "SourceTimestamp""2022-03-29 17:31:06"

                }

            ]

        },

        "ApplicationID""{56CDF444-B238-4609-9137-148A34B08F59}",

        "Command""DynamicCurrencyConversion",

        "Mode""Live",

        "RequestID""{E575AA65-8C06-4814-B9CC-A99AD4C06EB1}",

        "Result": {

            "Status""0",

            "Code""0",

            "Description""",

            "AppServer""QA2019GWAPP01",

            "DBServer""QA2019GWDB02",

            "Gateway""QA",

            "AcquirerCode""00",

            "AcquirerDescription"""

        }

    }

}

 

<?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="{56CDF444-B238-4609-9137-148A34B08F59}" Command="DynamicCurrencyConversion" Mode="Live" RequestID="{0192B92C-E645-4E67-877D-4EEB71492818}"&gt;

    &lt;Result Status="0" Code="0" Description="" AppServer="QA2019GWAPP01" DBServer="QA2019GWDB02" Gateway="QA" AcquirerCode="00" AcquirerDescription="" /&gt;

    &lt;MerchantName&gt;Busiswa&lt;/MerchantName&gt;

    &lt;MerchantUSN&gt;1732460&lt;/MerchantUSN&gt;

    &lt;Acquirer&gt;NBPostilionNBSouthAfrica&lt;/Acquirer&gt;

    &lt;AcquirerReference&gt;02848:09021749&lt;/AcquirerReference&gt;

    &lt;AcquirerDate&gt;20221230&lt;/AcquirerDate&gt;

    &lt;AcquirerTime&gt;153200&lt;/AcquirerTime&gt;

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

    &lt;Amount&gt;2000&lt;/Amount&gt;

    &lt;MerchantAddress&gt;MERCHANT ADDRESS&lt;/MerchantAddress&gt;

    &lt;MerchantCity&gt;Sandton&lt;/MerchantCity&gt;

    &lt;MerchantCountryCode&gt;ZA&lt;/MerchantCountryCode&gt;

    &lt;MerchantCountry&gt;South Africa&lt;/MerchantCountry&gt;

    &lt;DistributorName&gt;Nedbank&lt;/DistributorName&gt;

    &lt;ForeignExchange&gt;

      &lt;ForeignExchangeItem Version="1.0"&gt;

        &lt;ForeignExchangeID&gt;{62EC3B82-BD4A-40D0-9AB1-79996761A17E}&lt;/ForeignExchangeID&gt;

        &lt;ForeignExchangeProvider&gt;Fexco&lt;/ForeignExchangeProvider&gt;

        &lt;BaseCurrency&gt;ZAR&lt;/BaseCurrency&gt;

        &lt;BaseAmount&gt;20.00&lt;/BaseAmount&gt;

        &lt;ForeignCurrency&gt;KES&lt;/ForeignCurrency&gt;

        &lt;ForeignAmount&gt;162.12&lt;/ForeignAmount&gt;

        &lt;ExchangeRate&gt;8.1058&lt;/ExchangeRate&gt;

        &lt;ExpiryDateTime&gt;2023-12-30 15:30:27&lt;/ExpiryDateTime&gt;

        &lt;MarginPercentage&gt;3.5&lt;/MarginPercentage&gt;

        &lt;CommissionPercentage&gt;0.000000&lt;/CommissionPercentage&gt;

        &lt;Source&gt;REUTERS WHOLESALE INTERBANK&lt;/Source&gt;

        &lt;SourceTimestamp&gt;2022-03-29 17:31:06&lt;/SourceTimestamp&gt;

      &lt;/ForeignExchangeItem&gt;

    &lt;/ForeignExchange&gt;

  &lt;/Enquiry&gt;

&lt;/V_XML&gt;</ExecuteResult>

        </ExecuteResponse>

    </soap:Body>

</soap:Envelope>

 

 Perform a transaction using the customers elected currency

 

REST

SOAP

Request

 

{

    "Version""2.0",

    "CertificateID""{4c96973f-71dd-4044-802d-6e234effe8f2}",

    "ProductType""Enterprise",

    "ProductVersion""WebAPI",

    "Direction""Request",

    "Transaction": {

        "ApplicationID""{56cdf444-b238-4609-9137-148a34b08f59}",

        "Command""Debit",

        "Mode""LIVE",

        "MerchantReference""Farm_12098",

        "MerchantTrace""20220520_1631",

        "Currency""ZAR",

        "Amount""5000",

        "ExpiryDate""1225",

        "CardSecurityCode""001",

        "PAN""5185520050000010",

        "ForeignAmount""40529",

        "ForeignCurrency""KES",

        "ForeignExchangeID":"{3056511A-360E-4C57-8437-4BEBE5CF0CD4}"

 

    }

}

 

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

    &lt;V_XML Version="2.0" CertificateID="{4c96973f-71dd-4044-802d-6e234effe8f2}" 

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

    &lt;Enquiry ApplicationID="{56cdf444-b238-4609-9137-148a34b08f59}" Command= Mode="Live"&gt;

    &lt;MerchantTrace&gt;240X568VFEEE&lt;/MerchantTrace&gt;

    &lt;Amount&gt;2000&lt;/Amount&gt;

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

    &lt;ExpiryDate&gt;1225&lt;/ExpiryDate&gt;

    &lt;MerchantReference&gt;20220104.1525&lt;/MerchantReference&gt;

    &lt;CardSecurityCode&gt;001&lt;/CardSecurityCode&gt;

    &lt;PAN&gt;5185520050000010&lt;/PAN&gt;

    &lt;/Enquiry&gt;&lt;/V_XML&gt;

        &lt;ForeignExchangeID&gt;{62EC3B82-BD4A-40D0-9AB1-79996761A17E}&lt;/ForeignExchangeID&gt;

        &lt;ForeignCurrency&gt;KES&lt;/ForeignCurrency&gt;

        &lt;ForeignAmount&gt;16212&lt;/ForeignAmount&gt;

 

</request>

  </Execute>

  </soap:Body>

  </soap:Envelope>

 

 

Response

{

    "Version""2.0",

    "Direction""Response",

    "Transaction": {

        "MerchantTrace""20220520_1631",

        "Amount""5000",

        "AuthorisationCode""012247",

        "CCNumber""5185........0010",

        "Currency""ZAR",

        "ExpiryDate""122025",

        "MerchantReference""Farm_12098",

        "Terminal""Default",

        "TransactionIndex""{C4BF6D8A-E6DF-4B92-8B40-056CA516A5FE}",

        "MerchantName""Busiswa",

        "MerchantUSN""1732460",

        "Acquirer""NBPostilionNBSouthAfrica",

        "AcquirerReference""02848:09021750",

        "AcquirerDate""20221230",

        "AcquirerTime""155823",

        "DisplayAmount""R 50.00",

        "BIN""5",

        "Association""MasterCard",

        "CardType""Unknown Card Type",

        "Issuer""Unknown Issuer",

        "Jurisdiction""International",

        "PAN""5185........0010",

        "PANMode""Keyed",

        "ReconReference""09021750",

        "CardHolderPresence""CardNotPresent,MOTO",

        "MerchantAddress""MERCHANT ADDRESS",

        "MerchantCity""Sandton",

        "MerchantCountryCode""ZA",

        "MerchantCountry""South Africa",

        "DistributorName""Nedbank",

        "ForeignAmount""40529",

        "ForeignCurrency""KES",

        "DisplayForeignAmount""KSh 405.29",

        "ApplicationID""{56CDF444-B238-4609-9137-148A34B08F59}",

        "Command""Debit",

        "Mode""Live",

        "RequestID""{F9EE9359-9D62-46C3-AE4E-97E151A8EB6E}",

        "Result": {

            "Status""0",

            "Code""0",

            "Description""",

            "AppServer""QA2019GWAPP01",

            "DBServer""QA2019GWDB02",

            "Gateway""QA",

            "AcquirerCode""00",

            "AcquirerDescription"""

        }

    }

}