Create payment with currency conversion

Creates a payment with a foreign credit card requesting currency conversion

EnvironmentMethodEndpoint
Sandboxhttps://apisandbox.cieloecommerce.cielo.com.br/1/sales/
Productionhttps://api.cieloecommerce.cielo.com.br/1/sales/

Request will be the same as a standard credit transaction, with the addition of the DynamicCurrencyConversion field set to true.

Response will return the CurrencyExchangeData node, which contains the conversion options:

  • Amount (ConvertedAmount);
  • Rate (ConversionRate);
  • Local currency (Currency).
"CurrencyExchangeData": {
      "CurrencyExchanges": [
        {
          "ConvertedAmount": 21,
          "ConversionRate": 0.2124,
          "Currency": "USD"
        }
      ]
}

Merchant must prepare the checkout page to present a screen with the currency conversion options to shopper, based on the options returned in the CurrencyExchangeData node.

ℹ️

Check the list of available currencies for conversion.

Attention: Example on this page shows the necessary parameters for Conversor de moedas e-commerce and only the mandatory parameters for a credit card transaction. To check all possible parameters, go to Create payment with credit card.

Language
Click Try It! to start a request and see the response here!