Create payment with currency conversion

ℹ️
Learn more about this feature in the documentation.

Ambiente	Método	Endpoint
Sandbox	post	`https://apisandbox.cieloecommerce.cielo.com.br/1/sales`
Produção	post	`https://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"
        }
      ]
}

Status 12: indicates that the transaction is pending, waiting for a confirmation request from the merchant to proceed with the transaction.

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.

Check the list of available currencies for conversion.

200200

400400