Criar pagamento com conversão de moeda

Cria um pagamento com cartão de crédito estrangeiro solicitando a conversão para a moeda local do comprador

AmbienteMétodoEndpoint
Sandboxhttps://apisandbox.cieloecommerce.cielo.com.br/1/sales
Produçãohttps://api.cieloecommerce.cielo.com.br/1/sales

ℹ️

Saiba mais sobre essa funcionalidade na documentação.

A requisição será igual a uma transação de crédito padrão, com a adição do campo DynamicCurrencyConversion igual a true.

A resposta irá retornar o nó CurrencyExchangeData, que contém as opções de conversão:

  • Valor (ConvertedAmount);
  • Taxa (ConversionRate);
  • Moeda local do cartão do comprador (Currency).
"CurrencyExchangeData": {
      "CurrencyExchanges": [
        {
          "ConvertedAmount": 21,
          "ConversionRate": 0.2124,
          "Currency": "USD"
        }
      ]
}

A loja deve preparar a página de checkout para apresentar uma tela com as opções de conversão de moedas ao comprador, com base nas opções retornadas no nó CurrencyExchangeData.

ℹ️

Confira a lista de moedas disponíveis para conversão.

Atenção: O exemplo desta página apresenta os parâmetros necessários para o Conversor de Moedas E-commerce e apenas os parâmetros obrigatórios para uma transação de cartão de crédito. Para verificar todos os parâmetros possíveis, vá para Criar pagamento com cartão de crédito.

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