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> <V_XML Version="2.0" CertificateID="{4c96973f-71dd-4044-802d-6e234effe8f2}" ProductType="Enterprise" ProductVersion="iVeriWebService" Direction="Request"> <Enquiry ApplicationID="{56cdf444-b238-4609-9137-148a34b08f59}" Command="DynamicCurrencyConversion" Mode="Live"> <MerchantTrace>240X568VFEEE</MerchantTrace> <Amount>2000</Amount> <Currency>ZAR</Currency> <ExpiryDate>1225</ExpiryDate> <MerchantReference>20220104.1525</MerchantReference> <CardSecurityCode>001</CardSecurityCode> <PAN>5185520050000010</PAN> </Enquiry></V_XML> </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><V_XML Version="2.0" Direction="Response"> <Enquiry ApplicationID="{56CDF444-B238-4609-9137-148A34B08F59}" Command="DynamicCurrencyConversion" Mode="Live" RequestID="{0192B92C-E645-4E67-877D-4EEB71492818}"> <Result Status="0" Code="0" Description="" AppServer="QA2019GWAPP01" DBServer="QA2019GWDB02" Gateway="QA" AcquirerCode="00" AcquirerDescription="" /> <MerchantName>Busiswa</MerchantName> <MerchantUSN>1732460</MerchantUSN> <Acquirer>NBPostilionNBSouthAfrica</Acquirer> <AcquirerReference>02848:09021749</AcquirerReference> <AcquirerDate>20221230</AcquirerDate> <AcquirerTime>153200</AcquirerTime> <Currency>ZAR</Currency> <Amount>2000</Amount> <MerchantAddress>MERCHANT ADDRESS</MerchantAddress> <MerchantCity>Sandton</MerchantCity> <MerchantCountryCode>ZA</MerchantCountryCode> <MerchantCountry>South Africa</MerchantCountry> <DistributorName>Nedbank</DistributorName> <ForeignExchange> <ForeignExchangeItem Version="1.0"> <ForeignExchangeID>{62EC3B82-BD4A-40D0-9AB1-79996761A17E}</ForeignExchangeID> <ForeignExchangeProvider>Fexco</ForeignExchangeProvider> <BaseCurrency>ZAR</BaseCurrency> <BaseAmount>20.00</BaseAmount> <ForeignCurrency>KES</ForeignCurrency> <ForeignAmount>162.12</ForeignAmount> <ExchangeRate>8.1058</ExchangeRate> <ExpiryDateTime>2023-12-30 15:30:27</ExpiryDateTime> <MarginPercentage>3.5</MarginPercentage> <CommissionPercentage>0.000000</CommissionPercentage> <Source>REUTERS WHOLESALE INTERBANK</Source> <SourceTimestamp>2022-03-29 17:31:06</SourceTimestamp> </ForeignExchangeItem> </ForeignExchange> </Enquiry> </V_XML></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> <V_XML Version="2.0" CertificateID="{4c96973f-71dd-4044-802d-6e234effe8f2}" ProductType="Enterprise" ProductVersion="iVeriWebService" Direction="Request"> <Enquiry ApplicationID="{56cdf444-b238-4609-9137-148a34b08f59}" Command= Mode="Live"> <MerchantTrace>240X568VFEEE</MerchantTrace> <Amount>2000</Amount> <Currency>ZAR</Currency> <ExpiryDate>1225</ExpiryDate> <MerchantReference>20220104.1525</MerchantReference> <CardSecurityCode>001</CardSecurityCode> <PAN>5185520050000010</PAN> </Enquiry></V_XML> <ForeignExchangeID>{62EC3B82-BD4A-40D0-9AB1-79996761A17E}</ForeignExchangeID> <ForeignCurrency>KES</ForeignCurrency> <ForeignAmount>16212</ForeignAmount>
</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": "" } } }
|
|