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
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);

Resposta da transação de conversão de moeda

"CurrencyExchangeData": {
      "CurrencyExchanges": [
        {
          "ConvertedAmount": 21,
          "ConversionRate": 0.2124,
          "Currency": "USD"
        }
      ]
}

Status 12: indica que a transação está pendente, aguardando uma requisição de confirmação da loja para prosseguir com a transação.

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.

ℹ️

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.

Body Params
string
required

Identificação do pedido. Poderá ser usada para cancelar ou consultar a transação no futuro.
Atenção: Os caracteres permitidos são apenas a-z, A-Z, 0-9. Não são permitidos caracteres especiais e espaços em branco.
Tamanho: 50.

Customer
object
Payment
object
Headers
string
required

Identificador da loja na Cielo. Tamanho: 36. Formato: GUID.

string
required

Chave pública para autenticação dupla na Cielo. Tamanho: 40. Formato: GUID.

string

Identificador da requisição, usado quando a loja usa diferentes servidores para cada GET/POST/PUT. Tamanho: 36.

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json