Simulador de Parcelas para Loja Virtual

By Renato Froes

★ 5.0/5 (2 ratings)90+ active installationsVersion 1.5.1

Display Mercado Pago installment estimates and optional Pix comparisons in WooCommerce products, pages, blocks, templates and modals.

Description

Simulador de Parcelas queries Mercado Pago installment conditions for the product’s storefront display price and presents an estimate in your WooCommerce store.

Choose a default presentation for product pages or use different formats in pages, templates, popups and modals through a shortcode, dynamic Gutenberg block or Elementor widget. The storefront interface remains available in Brazilian Portuguese.

Display modes

  • Expandable summary: highlights the preferred installment and lets shoppers expand the other options.
  • Full table: displays the available installments, installment amounts and totals in a responsive table.
  • Modal trigger: opens an accessible installment dialog from a compact button.

Features

  • Live previews of all three modes in the settings screen.
  • Optional installment summary on product cards.
  • Configurable placement, colors, alignment and card prefix.
  • Shared response cache to reduce repeated API requests.
  • Server-side requests with the Access Token in the Authorization header.
  • Dynamic updates after selecting or resetting a WooCommerce variation.
  • Global, category and product rules for installment limits, minimum amounts and interest-free preference.
  • Dynamic Gutenberg block and Elementor widget.
  • Configurable reference card brand.
  • Environment diagnostics and declared HPOS and Cart/Checkout Blocks compatibility.
  • Optional reuse of the official Mercado Pago checkout connection, following its test or production environment.
  • Independent manual token and fallback when the official credential is unavailable.
  • Optional informational comparison between a valid Pix discount and the preferred installment.
  • Optional synchronization with the active Checkout Pro installment limit.
  • Tax-aware display amounts shared by the product component, variations, Pix comparison and product cards.
  • Clear notice when no installment meets the configured rules; excluded options are not restored as a fallback.

The simulator does not process payments or add a second purchase button. Final installment conditions depend on the card, issuer and checkout. A manual Pix percentage must match the discount actually applied by your checkout; the plugin cannot verify an independent checkout’s configuration.

Shortcodes

Use [simuparc_parcelamento] for the current product and store or product display mode.

Use [simuparc_parcelamento produto_id="123"] to select a product explicitly outside its product page.

The exibicao attribute accepts resumo, tabela or modal:

[simuparc_parcelamento produto_id="123" exibicao="resumo"]

[simuparc_parcelamento produto_id="123" exibicao="tabela"]

[simuparc_parcelamento produto_id="123" exibicao="modal"]

In Gutenberg and Elementor, look for Simulador de Parcelas. The block and widget let you choose a product and display mode. Shortcodes remain available for templates, popups and other integrations.

External services

The plugin connects to the Mercado Pago API to retrieve installment estimates for a product amount.

Data sent:

  • The storefront display amount (amount).
  • The configured reference payment method (payment_method_id), such as visa or master.
  • The store administrator’s configured Access Token, sent in the server-side Authorization header.

Purpose:

  • Retrieve and display estimated installment conditions for that amount.

Service:

  • Mercado Pago Installments API: https://api.mercadopago.com/v1/payment_methods/installments
  • Terms of use: https://www.mercadopago.com.br/ajuda/termos-e-condicoes_194
  • Privacy policy: https://www.mercadopago.com.br/ajuda/politica-de-privacidade_188

Support

For support and contributions, visit https://renatofroes.com.br/contatos

Installation

  1. Install and activate WooCommerce.
  2. In WordPress, open Plugins > Add New, find this plugin and activate it.
  3. Open Settings > Simulador de Parcelas.
  4. Choose the official Mercado Pago connection or provide an independent Access Token.
  5. Test the connection, configure the presentation, rules and appearance, and save your settings.

FAQ

Is WooCommerce required?

Yes. The plugin uses WooCommerce product data and display prices.

Does it support Elementor and Gutenberg?

Yes. It includes a native Elementor widget and dynamic Gutenberg block. Shortcodes also remain available. Set produto_id when there is no current product context.

Does it support variable products?

Yes. Selecting a variation updates the estimate using that variation’s display price while preserving the parent product’s rules. New selections take precedence over older pending responses.

Can I limit installments or require a minimum installment amount?

Yes. Configure global rules or category/product overrides. If no returned condition meets the rules, the component displays an availability notice instead of advertising an excluded installment. Product cards omit the estimate in this case.

Can I place the simulator inside another modal?

Yes. Use exibicao="tabela" inside an existing modal, or exibicao="modal" for the plugin’s dialog.

Are the displayed amounts final?

No. These are estimates based on the configured reference card brand and the Mercado Pago response, which may be cached. Final conditions can vary by card, issuer and checkout.

Is the Access Token exposed in the browser?

Saved credentials are not returned in the settings HTML. The server sends the token to Mercado Pago in the Authorization header, not in the request URL.

Can the plugin reuse the official Mercado Pago checkout connection?

Yes. Select the official connection in the settings. The simulator follows the active test or production environment without copying the official credential into its own settings. Manual credentials remain available as an independent alternative and fallback.

Can I compare Pix and installment payments?

Yes. Enable the smart offer and choose the active official Pix discount or a manually confirmed percentage. No comparison is displayed without a positive valid discount and eligible installments. The comparison is informational and does not start a purchase.

Does it support tax display settings?

The queried amount follows WooCommerce’s storefront price display, including its tax configuration and the selected variation’s active price. Check the comparison against your checkout when using custom pricing, currency or discount extensions.

Screenshots

Changelog

1.5.1

  • Fixed: declare the jQuery dependency before registering variation handlers.
  • Fixed: discard obsolete variation responses so rapid selections keep the latest estimate.
  • Fixed: use the storefront display price, including tax settings, for product estimates, variations, cards and Pix comparisons.
  • Fixed: do not restore installments excluded by maximum or minimum rules.
  • Improved: clear empty-state notices retain the component so later variation selections can recover.
  • Compatibility: tested against WordPress 7.1.4 and WooCommerce 11.2.2.

1.5.0

  • Added an optional informational smart offer comparing Pix savings with the preferred installment.
  • Added detection of the active official Mercado Pago Pix discount and an independent manual percentage.
  • Added global, category and product visibility rules for the smart offer.
  • Added optional synchronization with the active Checkout Pro installment limit.
  • Added a dedicated settings tab with integration status and a live preview.
  • Kept the comparison hidden without a valid discount and free of competing purchase buttons.

1.4.0

  • Added optional reuse of the official Mercado Pago checkout credentials and environment.
  • Preserved independent manual credentials and fallback behavior.
  • Added connection source selection and checkout consistency diagnostics.
  • Prevented saved credentials from being returned to the settings page.
  • Preserved manual connection behavior for existing installations.

1.3.0

  • Added installment limits, minimum amounts and interest-free preference.
  • Added product and category overrides and dynamic variation updates.
  • Added native Gutenberg and Elementor integrations, reference card selection and diagnostics.
  • Declared HPOS and Cart/Checkout Blocks compatibility.
  • Added adaptive block registration for older WordPress versions and API3 for newer versions.

1.2.0

  • Added expandable summary, full table and accessible modal presentations.
  • Added flexible shortcodes and live administrative previews.
  • Moved the Access Token from the URL to the Authorization header.
  • Shared the response cache across product pages, shortcodes and cards.
  • Improved keyboard controls, ARIA semantics, theme isolation and responsive table layout.

1.1.0

  • Added optional product-card summaries, alignment, color, prefix and response caching.

1.0.1

  • Initial release.