-
Introduction
-
Commands & Actions
-
Transaction Sequence
-
MasterPass
-
Visa Checkout
-
Foreign Exchange
-
Parameter Description & Action
-
Gateway Domain Knowledge
-
Transaction Result Codes
-
Out Of Band
-
Payment Facilitator
-
Tokenization
-
SOAP API
-
Pos Device Intergration
-
Acquire Contact Information
-
3D Secure
-
Enterprise API Samples
-
Card on File
-
Additional Data Transactions
Dynamic Currency Conversion is a service that enables cardholders to make international card purchases or transactions in their own currency. The conversion of the purchase price of goods or services from the merchant’s local currency to the cardholder’s home currency occurs at the point of sale at the quoted exchange rate from a cited exchange rate source.
Merchant Requirements
- Merchant must enter into an agreement with an acquiring institution for DCC acceptance
- The merchants application iD must be enabled for DCC on the iVeri Gateway. Additionally, the merchant ID responsible for accepting DCC payments should be configured on the Gateway and acquiring institution that holds the merchant agreement
- For enablement purposes, support can be contacted on assist@iveri.com
DCC Transaction Flow
1. Perform an enquiry DCC rate request using a PAN and Amount to the iVeri Gateway
2. Merchant presents the returned DCC rate offer to the customer
3. Perform a transaction using the customers elected currency
Step 1: Sample – DCC
Request with Specified PAN and Base Amount
|
REST Request | SOAP Response |
|
{ "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>
|
|
REST and SOAP 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>
|
Step 2: Present DCC offer to the customer
When the DCC rate is returned by the iVeri Gateway, the merchant should present the rate offer to the customer. In turn, the offer allows the customer to choose if they want to pay for services/goods in their native or merchant currency.
Step 3: Sample - 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}"
} }
|
|
|
|
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": "" } } }
|
|