Cujiware Gateway – Mercado Pago for WooCommerce

By kijam

0+ active installationsVersion 3.0.5

Accept Mercado Pago payments in WooCommerce: Checkout Pro, card payments, QR, subscriptions and marketplace split payments.

Description

Accept Mercado Pago in WooCommerce with three payment methods: Checkout Pro, card payments without leaving the store, and QR.

  • Recurring payments with Mercado Pago for WooCommerce Subscriptions, Subscriptions for WooCommerce (WP Swings) and YITH WooCommerce Subscription.
  • Interest-free installments, surcharges per payment method and currency conversion.
  • Marketplace split payments for Dokan, WCFM, WC Vendors and Tutor LMS.
  • Refunds and automatic payment status synchronization.
  • Argentina, Brazil, Chile, Colombia, Mexico, Peru and Uruguay.

Requires a paid Cujiware license. See the plans.

External services

Nothing is sent until the administrator saves a Cujiware license.

Cujiware service

Processes the payments on behalf of the store. It receives the license, settings and the order data needed to charge. Terms · Privacy

Mercado Pago

Payment provider; its scripts are loaded at checkout. Terms · Privacy

Installation

  1. Install and activate WooCommerce.
  2. Upload the plugin folder to /wp-content/plugins/ or install it from the Plugins screen, then activate it.
  3. Go to WooCommerce > Settings > Integration > Mercado Pago Tools Pro, enter your Cujiware license and save.
  4. Enter your Mercado Pago credentials (access token and public key) and save.
  5. Enable the payment methods in WooCommerce > Settings > Payments.

FAQ

Do I need a license?

Yes, a paid Cujiware license and a Mercado Pago seller account. See the plans.

What if the Cujiware service or Mercado Pago is down?

The store keeps working; the Mercado Pago methods are hidden until the service is back, and pending notifications are processed afterwards.

Upgrading from 2.x?

Nothing to configure: settings, orders, subscriptions and the license are kept.

Which subscription plugins are supported?

WooCommerce Subscriptions, Subscriptions for WooCommerce (WP Swings) and YITH WooCommerce Subscription, one active at a time. Combinations Mercado Pago can not charge are blocked at checkout.

Screenshots

Changelog

3.0.5

  • Improved: when Mercado Pago charges a subscription renewal but the payment notification never reaches the store (for example, a hosting firewall that answers it without running WordPress), the periodic subscription check now finds the charge and completes the pending renewal order. Only payments of that same Mercado Pago subscription are used, never one already applied to another order.

3.0.4

  • New: support for Subscriptions for WooCommerce (WP Swings) and YITH WooCommerce Subscription.
  • Improved: reliability with many subscriptions charged on the same day (no lost notifications, per-order locking).
  • Fixed: subscriptions created from a Mercado Pago plan are matched to their order even without an external reference.

3.0.3

  • Fixed: subscriptions created from a Mercado Pago plan were not activated after the first payment was approved.
  • Fixed: the payment method of a subscription could be shown empty (“Via”) when another plugin or theme blanked the gateway title.

3.0.2

  • New: Spanish (es_AR, es_CL, es_CO, es_ES, es_MX, es_PE, es_UY, es_VE) and Portuguese (pt_BR) translations included in the plugin. They are used only when translate.wordpress.org has no language pack for the site language.

3.0.1

  • Changed: the plugin and the Cujiware service now exchange only their own minimal data format. No Mercado Pago object is sent to or received from the store any more (responses, callbacks, errors and requests).
  • Changed: every request to the service carries the plugin, WooCommerce, WordPress and PHP versions inside the signed body.
  • Removed: the woocommerce_kmercadopago_args filter. Use the new kmercadopago_checkout_overrides filter instead: apply_filters( 'kmercadopago_checkout_overrides', array(), $order, $gateway_id ) returns an array with any of statement_descriptor (string, up to 22 letters, digits, spaces, ., *, -), item_title (string), description (string), binary_mode (bool), metadata (array of scalar values, keys a-z0-9_), and, for Checkout Pro only, excluded_methods (string[]), excluded_types (string[]: credit_card, debit_card, ticket, atm, bank_transfer, prepaid_card, digital_currency, digital_wallet, account_money), max_installments (1-48) and expiration_minutes (5-525600). Values are validated by the service; invalid values are ignored. Order reference, notification URL, amounts and fees can not be changed.
  • Changed: kmercadopago_get_preapproval() and the kmercadopago_pre_update_subscription / kmercadopago_post_update_subscription hooks now receive the subscription as an array with ref, order_id, state (pending, active, paused, cancelled), amount, currency, reason, billing (interval, unit), next_charge_at and started_at (Unix timestamps or null), trial (length, unit, or null), charges (count, last_at) and plan_ref. The third argument of kmercadopago_post_update_subscription is false or an array with updated, http_code, amount and reason.
  • Changed: kmercadopago_get_preapproval_plan() returns ref, active, amount, currency, reason and billing. The third argument of kmercadopago_post_sync_subscription_amount is an array with changed, amount_changed, amount and reason.
  • Changed: the mp_preferences and mp_tokenize order data are no longer written.
  • Fixed: the Mercado Pago order number is saved on approved payments.
  • Changed: the plugin hooks, cron events and schedules, script handles, classes, tables and stored keys now use the kmercadopago prefix. Renamed: actions check_ipn_response -> kmercadopago_check_ipn_response and woocommerce_kmercadopago_metabox -> kmercadopago_metabox; cron events woo_sub_cronjob_function -> kmercadopago_sub_cron, do_kmercadopago_hourly_check -> kmercadopago_hourly_check, do_kmercadopago_refresh_token -> kmercadopago_refresh_token; schedule 5_minutes -> kmercadopago_five_minutes; classes WC_KMercadoPago* -> KMercadoPago*; tables woo_kmercadopago / woo_kmercadopago_sub -> kmercadopago / kmercadopago_sub; product and category meta _max_installments, _marketplace_fee, _fee_installments_msi_* -> _kmercadopago_*. Existing data, scheduled events and webhook URLs are migrated or keep working automatically.
  • Changed: the QR image is stored in wp-content/uploads/cujiware-gateway-mercado-pago/qr.png (the previous image is copied automatically).
  • Changed: translations are delivered by translate.wordpress.org.
  • Changed: admin notices are only shown on the plugin settings screen to users who can manage WooCommerce.

3.0.0

  • New: payment logic moved to the Cujiware service; the plugin code is now open source (GPLv2 or later).
  • New: plugin renamed to “Cujiware Gateway – Mercado Pago for WooCommerce” (slug cujiware-gateway-mercado-pago). Version 2.x is deactivated automatically on upgrade and all its data is kept.
  • New: English source texts with Spanish (es_ES, es_AR, es_MX, es_CO, es_CL, es_PE, es_UY, es_VE) and Brazilian Portuguese translations.
  • New: the Mercado Pago payment methods are hidden automatically while Mercado Pago or the service is unavailable.
  • Security: nonces on all forms and AJAX requests, sanitized input and escaped output, signed service callbacks.
  • Improved: the QR image upload uses the WordPress upload API.