Creates a payment with a foreign credit card requesting currency conversion
Environment | Method | Endpoint |
---|---|---|
Sandbox | post | https://apisandbox.cieloecommerce.cielo.com.br/1/sales/ |
Production | 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"
}
]
}
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.