Confirmar a conversão de moeda

Confirma a conversão do pagamento em reais para a moeda do cartão estrangeiro

AmbienteMétodoEndpoint
Produçãohttps://api.cieloecommerce.cielo.com.br/1/sales/{PaymentId}/confirm

ℹ️

Saiba mais sobre essa funcionalidade na documentação.

Depois que o comprador decide pagar na moeda estrangeira, a loja deve enviar a requisição de confirmação da conversão com o campo CurrencyConversion igual a true. Após a confirmação, a API E-commerce Cielo irá submeter a transação para autorização.

⚠️

Atenção ao tempo limite para confirmação

A confirmação deve ser feita em até vinte minutos.

Se o tempo para confirmação da moeda desejada for superior a vinte minutos, a API irá retornar o código 020 com a mensagem “Status não permite autorização”.

Se a captura não for automática (Payment.Capture igual a true), a captura posterior também deve se feita em até 20 minutos, para garantir o câmbio ao comprador.

Path Params
string
required

Número de identificação do pagamento, necessário para futuras operações como Consulta, Captura e Cancelamento. Tamanho: 36.

Body Params
boolean
required

Booleano que confirma que o comprador optou por realizar a conversão.
Quando true, indica que a transação será submetida para autorização na moeda estrangeira.
Quando false, indica que a transação será submetida para autorização em reais.

Headers
string
required
Defaults to 8937bd5b-9796-494d-9fe5-f76b3e4da633

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

string
required
Defaults to XKGHUBSBKIRXKAVPSKWLVXYCLVJUGTNZLIHPUSYV

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