Multicurrency Service
Introduction
The CyberSource multicurrency service obtains current, guaranteed exchange rates. This service enables you to list your product prices in your customers’ local currencies on your web site. It also enables your customers to pay using their local currencies, while allowing you to do business and settle transactions in your desired currency.
On your web site, you can present your customers with guaranteed localized prices. When the transaction is approved, the customer knows the exact amount that will be charged to their account in their local currency. Additionally, you know the exact amount that you will receive in your own funding currency.
Each exchange rate has an identifier called a quote ID that guarantees the rate between two currencies for a given period of time.
Requirements
Before you can use the multicurrency service, you must have your account configured with both CyberSource and E4X.
When you sign up to use the multicurrency service, you need to provide this information:
Ways to Use the Multicurrency Service
You can use the multicurrency service in two ways: Variable Price Mode and Fixed Price Mode.
Variable Price Mode
In this mode, you can use the multicurrency service to dynamically display local prices on your web site. The local prices you display will vary with the exchange rates.
These are the general steps to follow:
Step 1
Step 2
When a customer uses your web site, use your stored exchange rate information to display your product prices in the customer’s local currency.
Step 3
When converting prices and calculating the total authorization amount, use the procedure Calculating an Amount.
In the authorization reply, CyberSource returns the quote ID used for the transaction, the transaction amount in both currencies, and additional exchange rate information.
Fixed Price Mode
In this mode, you can show fixed local prices on your web site and determine on your own the fixed prices of your products in the local currencies.
If you are an existing CyberSource merchant, this mode does not require you to change your existing code to use any new API request fields or services. In your authorization request, the currency that you specify is the customer’s local currency and the offer amounts that you specify are in the customer’s local currency.
CyberSource determines the appropriate quote ID to use. In the authorization reply, CyberSource returns the quote ID that was used, the transaction amount in both currencies, and additional exchange rate information.
Funding Currency
With the multicurrency service, your business can use more than one funding currency. When you configure your account with E4X, you specify which funding currencies you want to use. The way you specify the funding currency for a particular order depends on the mode you are using:
Variable Price Mode: The quote ID that you send in your authorization request specifies the funding currency to use for the order.
Fixed Price Mode: By default, CyberSource uses the funding currency configured for your CyberSource account. You can override this currency by specifying in your authorization request the funding currency that you want to use for the order.
Captures and Credits
To perform a capture or credit of an authorization that used the multicurrency service, you do not need to send any additional fields in your request. For credits, you can override the funding currency configured for your merchant ID.
The quote ID used for the capture or credit is determined by E4X based on your agreement with them. Typically a capture that occurs within five to seven days after the authorization will use the same quote ID that was used for the authorization.
In the capture reply, CyberSource returns the quote ID used for the transaction, the transaction amount in both currencies, and additional exchange rate information.
In the credit reply, CyberSource returns the amount of the credit in the customer’s currency.