Foreign Exchange (FX)
This page provides workflows for the FX Service through Dynamic Currency Conversion (DCC) and Presentment Currency Conversion (PCC).
DCC Workflow
The following sequence diagram shows the FX Service workflow:
The workflow of DCC is as follows:
- After Initialize Payment is successful, the merchant application shows the payment page.
- The
dccenabled
flag ininitialize-payment
checks eligibility for invoking currency conversion flow for a card.
- When a customer enters a card number or selects a stored card and the card type is eligible for DCC, the front-end application calls Velocity POP to get the exchange rates and other meta data related to the exchange rates.
Note: DCC is applicable for Visa and Mastercard cards only.
- The Velocity POP connects to the third-party FX provider and retrieves the exchange rates.
- Depending on what option the customer selects, the merchant application sends the DCC opt-in/opt-out information to the Velocity POP back-end in Pay and Authorize Payment calls.
- The back-end of the Velocity POP completes the payment authorization and returns the status.
- The Velocity back-end informs the third-party FX provider of the transaction status.
PCC Workflow
The following sequence diagram shows the FX Service workflow for PCC:
The workflow of PCC is as follows:
- After Initialize Payment is successful, the application front-end redirects to the payment options page.
- If a payment cannot be settled in the currency of payment initialization, the Initialize Payment response provides the
presentment
flag in the response in the card node.
- To invoke a currency conversion flow for a given payment method, the Initialize Payment response provides the
dccenabled
flag for checking eligibility.
- The Initialize Payment response provides a list of settlement currencies. The merchant application needs to invoke a request for exchange rates for presentment currency to settlement-currency.
- When a customer selects a particular payment method, the application calls the front-end Velocity POP to get the exchange rates and other meta data related to exchange rates.
- The Velocity POP connects to third-party FX provider and retrieves the exchange rates if not present in cache for the given UTC date.
- Depending on what option the customer selects, the application sends the DCC opt-in/opt-out information to the Velocity POP in Pay and Authorize Payment calls.
- The Velocity POP completes the payment authorization and returns the status.
Updated 6 months ago