Enterprise Developer's Guide

0 %

课程内容

Dynamic Currency Conversion (DCC)

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.

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>

<validateRequest>false</validateRequest>

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

<MerchantReference>20220104.1525

</MerchantReference>

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

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

<Acquirer>NBPostilionNBSouthAfrica</Acquirer>

<AcquirerReference>02848:09021749

</AcquirerReference>

<MerchantAddress>MERCHANT ADDRESS

</MerchantAddress>

<MerchantCity>Sandton</MerchantCity>

<MerchantCountryCode>ZA

</MerchantCountryCode>

<MerchantCountry>South Africa

</MerchantCountry>

<DistributorName>Nedbank

</DistributorName>

<ForeignExchangeProvider>Fexco

</ForeignExchangeProvider>

<CommissionPercentage>0.000000

</CommissionPercentage>

<Source>REUTERS WHOLESALE INTERBANK

</Source>

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

}

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

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

ProductType="Enterprise" ProductVersion=

"iVeriWebService" Direction="Request">

<MerchantTrace>240X568VFEEE

</MerchantTrace>

<MerchantReference>20220104.1525

</MerchantReference>

<CardSecurityCode>001

</CardSecurityCode>

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

}

视图
523	总浏览
1	成员的观点
867	公众浏览

操作
0	喜爱
0	不喜欢
0	注释

Enterprise Developer's Guide

Dynamic Currency Conversion (DCC)

DCC Transaction Flow

Step 1: Sample – DCC Request with Specified PAN and Base Amount

Step 2: Present DCC offer to the customer

Step 3: Sample - Perform a transaction using the customers elected currency

分享到社交网络

分享链接

通过邮件分享