Cielo for WooCommerce PIX, Debit Card and Credit Card

The Cielo for WooCommerce plugin is a robust payment gateway designed to seamlessly integrate your WooCommerce store with Cielo, one of Brazil’s leading payment processors. With this plugin, you can empower your customers to pay using popular methods like PIX, Google Pay, and securely process both credit and debit cards, all while leveraging 3DS support for fast and protected transactions.

Setting up the plugin is straightforward, allowing you to quickly enable the main card brands accepted by Cielo API. It integrates natively with WooCommerce, ensuring a smooth and efficient checkout experience for your customers.

Key Features:
* Support for credit and debit cards;
* Seamless PIX integration for automatic payment confirmation;
* 3DS support for enhanced transaction security;
* Integration with Google Pay Wallet;
* Intuitive configuration directly within the WooCommerce dashboard;
* Compatible with all major card brands accepted by Cielo.

Unlock More with the PRO Version
Beyond the capabilities of the free version, the Cielo API PRO for WooCommerce offers an extensive array of advanced features to broaden your store’s payment options and refine your transaction management:

• Full and partial refunds managed effortlessly from the WooCommerce dashboard;
• Support for international currency payments, expanding your global reach;
• Recurring payments, perfect for subscriptions, memberships, and installment plans;
• Advanced PIX integration for instant payments with additional controls;
• The flexibility to offer installments up to 18x, providing more choice for customers;
• Precise configuration of the maximum number of installments and minimum installment amount, giving you greater control over payment terms;
• Integration with Boleto Bancário, a popular offline payment method in Brazil;
• And many more features and frequent updates to keep your store at the cutting edge.

With the CIELO PRO version, you gain access to a comprehensive and powerful solution designed to manage all transaction types efficiently, delivering a more convenient and personalized shopping experience for your customers.

** Recommended Plugins **
* Link Invoice Payment for WooCommerce – Integrate custom payment methods and offer invoice-based payments in your WooCommerce store.
* Shipping Calculator for Brazil – Provide accurate freight calculation for Brazilian addresses directly in your WooCommerce checkout.

Dependencies

Payment Gateway for Cielo API on WooCommerce plugin is dependent on WooCommerce plugin, please make sure WooCommerce is installed and properly configured before starting Payment Gateway for Cielo API on WooCommerce installation.

This plugin uses the Cielo API 3.0 to process payments. terms of service and privacy policy.

JS Libraries used
This plugin uses the React Credit Cards library to render an animated card in the checkout page.

User instructions

1. Go to WooCommerce settings menu;

2. Select the ‘Payments’ option and search for ‘Cielo credit card / Cielo debit card’;

3. Enter all necessary credentials for each payment gateway;

4. Enter in the WooCommerce checkout page and select ‘Cielo credit card / Cielo debit card’ option;

5. Enter your card information;

6. Click in the finish payment button.

1. Look in the sidebar for the WordPress plugins area;

2. In installed plugins look for the option ‘add new’;

3. Click on the ‘send plugin’ option in the page title and upload the lkn-wc-gateway-cielo.zip plugin;

4. Click on the ‘install now’ button and then activate the installed plugin;

5. Now go to WooCommerce settings menu;

6. Select the ‘Payments’ option and search for ‘Cielo credit card / Cielo debit card’;

7. Enter all necessary credentials for each payment gateway;

8. Click on save.

1. 

   Payment methods credit and debit card.

2. 

   Debit card configuration page.

3. 

   Debit card configuration page.

4. 

   Credit card configuration page.

5. 

   Credit card configuration page.

6. 

   Credit card front page with payment fields.

7. 

   Debit card front page with payment fields.

1.26.0

** 17/10/2025 **
* Adjustments to the order summary.
* Added interest percentage to installments.
* Fixed WooCommerce footer in settings.

1.25.2

** 09/10/2025 **
* Changed hooks loading.

1.25.1

** 06/10/2025 **
* Fix in installment variable.
* Fix in PIX payment verification.

1.25.0

** 12/09/2025 **
* Adding of Google Pay payment gateway.
* Adding the gateway name to order notes.
* Adding the plugin icon to the gateways.

1.24.1

** 03/09/2025**
* Fix in payment metadata return.

1.24.0

** 02/09/2025**
* Addition of payment information in the

1.23.0

** 24/07/2025**
* Add PRO configuration to display the “Finalize and Generate PIX” button at checkout.

1.22.0

** 08/07/2025**
* New layout for credit and debit payment gateways.

1.21.5

** 23/06/2025**
* Fix Pix display issue.

1.21.4

** 20/06/2025**
* Fix payment processing logic.

1.21.3

** 18/06/2025**
* Fix final adjustments.

1.21.2

** 16/06/2025**
* Addition of new layout for the settings page(new version).

1.21.1

** 16/06/2025**
* Old version.

1.21.0

30/05/2025
* Addition of new layout for the settings page.

1.20.0

23/05/2025
* Add compatibility with PRO configuration to add discounts on installments.
* Add compatibility with PRO configuration to set the minimum value for interest-free installments.

1.19.2

24/04/2025
* Fix installment submission for payment methods.

1.19.1

07/04/2025
* Update descriptions of payment methods.

1.19.0

20/03/2025
* Add message to inform when credentials are incorrect;
* Duplicate scripts.

1.18.0

17/03/2025
* Payment method Pix.

1.17.2

12/03/2025
* Validation of the online card option at the time of payment;
* Fix currency display in installments.

1.17.1

17/02/2025
* Correction of reference for minimum value of installments;
* Update hooks reference to avoid collisions;
* Correction of nonce validation when configuration is disabled.

1.17.0

06/02/2025
* Added compatibility with retry settings for subscriptions.

1.16.0

31/01/2025
* Added the download notice for the plugin: fraud-detection-for-woocommerce.
* Added the plugin rating message in the footer.

1.15.0

20/12/2024
* Add function to renew token;
* Add configuration to display transaction logs in the order;
* Add animated card in the block editor checkout;
* Add configuration to show and hide animated card;
* Add automatic tab selection when the settings page is reloaded;
* Change credit payment method label;
* Change endpoint URLs.

1.14.1

06/12/2024
* Fix bug on show detailed logs on order.

1.14.0

05/12/2024
* Add compatibility with button to capture order;
* Add settings to include logs in the order;
* Fix layout script.

1.13.2

02/12/2024
* Fix for installment limitation hook;
* Fix for BIN query event in legacy form.

1.13.1

29/11/2024
* Fix order value formatting.

1.13.0

25/11/2024
* Add configuration to allow transactions without 3DS;
* Add filters to change card query URL;
* Change settings layout;
* Fix logger call.

1.12.1

06/11/2024
* Add fixes for 3DS 2.2 authentication.

1.12.0

22/10/2024
* Add compatibility with new WooCommerce Cielo PRO features.

1.11.5

10/10/2024
* Fix nonce validation;
* Change placeholders.

1.11.4

04/10/2024
* Added compatibility mode for nonce validation;
* Fixed error on invalid credit card submission.

1.11.3

02/10/2024
* Added improvements to field validation;
* Adjustments to redirection in case of payment failure;
* Fixed order with installments with interest has a different total value of the product.

1.11.2

27/09/2024
* Fix placeholders on WooCommerce classic checkout;
* Fix of calculation of installment amounts for customers with active Cielo PRO.

1.11.1

25/09/2024
* Fix installment values when changes are made to the cart.

1.11.0

02/09/2024
* Add translations for CPF field for Pix payments.
* Add compatibility with configuration to change status when the order is paid.

1.10.0

16/08/2024
* Add credit payments with 3DS validation;
* Add BIN validation to automatically select card type;
* Fix bug on debit 3DS render;
* Better compatibility with WooCommerce Cielo PRO;
* Add plugin dependence on WooCommerce.

1.9.3

18/06/2024
* Add compatibility with the Orders Auto-Complete functionality of the pro plugin;
* Fixed rendering issue for Cielo Debit 3DS card.

1.9.2

05/06/2024
* Correction of validation in the cardholder name field;

1.9.1

23/05/2024
* Correction of error in the cardholder field;
* Correction of error in validating fields in the new checkout template;
* Adjustments to installment recognition on invoices and non-standard WooCommerce pages.

1.9.0

22/05/2024
* Fixed error on form field inputs;
* Add error treatment for cardholder input field;
* Add cardholder input;
* Add be pro button.

1.8.1

16/05/2024
* Fixed error on the edit form page in blocks;

1.8.0

10/05/2024
* Added support for block-based checkout;
* Addition of hosting banner for WordPress;
* Addition of mandatory fields for credit and debit card credentials;
* Improvement in error handling;

1.7.0

25/03/2024
* Fixed 3DS script loading bug in the debit card option;
* Added logic to handle API responses when the return code is “GF”;
* Adjustment of the security code label;
* Addition of description in debit card settings;
* Addition of validation in the invoice description field;

1.6.0

27/11/2023
* 3DS script loading bug fix;
* Added display of additional card information in order details;
* Correction of mask bug in debit card fields;
* Removal of deprecated functions from JQuery;
* Added ‘view logs’ button in plugin settings.

1.5.0

• Implemented loading of global attributes to installment script.

1.4.0

• Validation compatibility mode implementation;
• Tweaks to settings descriptions;
• Update notice links;
• Storage of the number of installments in the order metadata;
• Added amount of installments in the thank you page and in the new order email.

1.3.2

• Fixed duplicate validation messages;
• Options loading tweaks;
• Admin area scripts directory change.

1.3.1

• Script load optimization;
• Removed unnecessary script loading.

1.3.0

• Field mask library refactor;
• Implemented preparation for interest recognition;
• Implemented warnings area on the front-end.

1.2.0

• Implemented BIN filter;
• Fixed input bugs on checkout page;
• Optimized script loading;
• Fixed debit card payment bug on checkout page.

1.1.0

• Installments implementation;
• Documentation update;
• Fixed validation error for expiration date input;
• Fixed 3DS initialization.

1.0.0

• Plugin launch.