Dynamic Currency Conversion (DCC) enhances the online shopping experience by allowing customers to choose between paying in the merchant's currency or their own card's currency. This feature provides transparency in pricing and empowers customers to make informed decisions, eliminating surprises in conversion rates or additional fees on their card statements.

Quick integration

For Redirect & Lightbox and Mobile SDK integrations, no modifications to your existing integration will be needed. The feature can be enabled globally by updating your merchant settings, making it easy to adopt with minimal effort.

DCC automatically detects the issuing country of the customer's card. If the card is eligible, it presents a currency conversion screen using Planet's latest exchange rates. Customers can select their preferred currency and review the converted rate before purchasing, ensuring a seamless and transparent payment experience.

Advanced integration with your own forms

A few changes will be required for merchants who would like to display the DCC choice for tokenized cards or stored PANs in their checkout.

After retrieving a token or collecting the PAN, you must call an additional API to access a given card's DCC eligibility and available currency options. After receiving these details, you can continue with the payment flow. Depending on your desired processing, various flows will be possible.

Retrieving DCC details

Call our DCC endpoint with the token or PAN, currency, and amount. Our response will include details on whether the card is eligible for DCC and the DCC details.

curl 'https://api.sandbox.datatrans.com/v1/transactions/dcc' \
--header 'Authorization: Basic {basicAuth}' \
--header 'Content-Type: application/json' \
--data-raw '{
	"alias": "{cardAlias}",
	"currency": "CHF",
	"amount": 100
}'

curl 'https://api.sandbox.datatrans.com/v1/transactions/dcc' \
--header 'Authorization: Basic {basicAuth}' \
--header 'Content-Type: application/json' \
--data-raw '{
	"cardNumber": "{cardNumber}",
	"currency": "CHF",
	"amount": 100
}'

{
 	"dccAvailable": true,
 	"originalOption": {
		"amount": 100,
		"currency": "CHF",
		"exponent": 2
	},
	"dccOption": {
		"amount": 107,
		"currency": "USD",
		"exponent": 2
	},
	"baseRate": "wholesale",
	"rate": 1.06015,
	"margin": 2.97
}

DCC with 3D Secure via Redirect & Lightbox

Merchants who only want to process 3DS with the DCC preselection previously retrieved within their frontend can now call the init endpoint with the returned DCC information. This will skip the payment method entry on our payment forms while still processing 3D Secure. The object dcc contains a parameter for the DCC currency, amount, and rate you must pass in your payload.

"dcc": {
	"currency": "USD",
	"amount": "107",
	"rate": "1.06015"
}

DCC without 3D Secure

When processing either a token or a PAN through our authorize endpoint, similar to the above examples you can also specify the DCC details in the object dcc.

"dcc": {
	"currency": "USD",
	"amount": "107",
	"rate": "1.06015"
}