Flows for unrealized conversion

When the shopper uses a foreign card but does not accept the currency conversion option or uses a national credit card or debit card, it will still be possible to create the transaction.

In these scenarios, it will also be mandatory to send the confirmation and the transaction will be authorized in Brazilian reais. Check out the possible flows below.

Flow with foreign credit card and sale in reais

In this scenario, the shopper does not agree with the presented currency conversion option. Merchant will send the transaction confirmation request with the CurrencyConversion field set to false and the transaction will be confirmed in reais.

Currency conversion stage

  1. On the merchant checkout page, shopper chooses to pay with a foreign credit card;
  2. Merchant's back-end sends the authorization request (POST/1/sales), informing the DynamicCurrencyConversion field as true;
  3. API E-commerce Cielo returns the CurrencyExchangeData node with the exchange rate options;
  4. Merchant's front-end displays the conversion options on the checkout page.

Confirmation stage

  1. Shopper does not agree to pay in the foreign currency;
  2. Merchant sends the conversion confirmation request with the CurrencyConversion field set to false (PUT/1/sales);
  3. API E-commerce Cielo proceeds with the authorization in reais and sends a success return;
  4. Merchant sends payment confirmation to shopper.

Flow with national credit card or debit card

In this scenario, the API will respond to the authorization request with a "card not eligible" return and the transaction will have a pending status. To proceed with the transaction creation, the store can send the confirmation request with the CurrencyConversion field set to false and the transaction will be confirmed in reais.

Currency conversion stage

  1. On the merchant checkout page, the shopper submits a payment request with a national credit card or debit card;
  2. Merchant back-end requests authorization (POST/1/sales), informing the DynamicCurrencyConversion field as true;
  3. API E-commerce Cielo returns informing that the national card is not eligible and the status will be pending (Status= 11).

Confirmation stage

  1. Merchant sends the transaction confirmation in reais to API Cielo E-commerce (PUT/1/sales), informing the CurrencyConversion field as false;
  2. API E-commerce Cielo authorizes and confirms the payment;
  3. Merchant sends payment confirmation to the shopper.