Mercado Pago Payments (Checkout Pro: Pix, Boleto, OXXO, Cards) changelog

All notable changes to Mercado Pago Payments (kv_mercado_pago) are documented here. The format follows Keep a Changelog and the project uses Semantic Versioning.

[Unreleased]

[1.0.0] - 2026-11-08

Added

• Initial release.
• Mercado Pago Checkout Pro (Preferences API) payment method for Argentina, Brazil, Chile, Colombia, Mexico, Peru and Uruguay: the customer pays on the Mercado Pago page (cards with installments, account money, Pix, boleto, OXXO and the other methods of the account) and returns to the order.
• Charges in the local currency of the account’s country (ARS, BRL, CLP, COP, MXN, PEN, UYU; CLP and COP as whole pesos); other store currencies are converted with the store’s rate. The method is hidden when the store cannot charge that currency.
• Notifications checked with the x-signature secret signature (HMAC-SHA256 manifest); every payment is read back from Mercado Pago (payment, or the merchant orders of the preference) before an order changes. Lost notifications are recovered by the customer’s return and a recurring check (35 days for vouchers).
• Pending payments (boleto, OXXO, Pix codes, reviews) open the order (configurable status) and are never shown as cancelled; the customer’s cart is emptied on the pending return (also the saved cart of a signed-in customer) and the voucher link is shown. Rejected cards leave the order alone so the buyer can retry on the same page.
• Several payments per checkout (a retry after a rejection, two cards): the order is paid when the whole amount is in.
• Money that does not match the order (duplicate attempt, different amount or currency, order total edited while pending) is booked and flagged; the order is not marked paid.
• Full and partial refunds from the order page and at a chosen order status, with X-Idempotency-Key, reserved before the call and repeated with the same key after an unclear answer; refunds are spread over the payments of a checkout.
• Cancellation of unpaid vouchers at Mercado Pago from the order page and when the order is cancelled.
• Payment method settings: title, card statement text (13 characters), maximum installments, hidden payment types, days to pay vouchers and Pix, binary mode.
• Multi-Vendor: one marketplace account (a cart of several vendors is one payment; each vendor order refunds its own share) or one account per vendor; refunds and cancellations are a privilege of the account holder.
• Connection page with encrypted Access token and secret signature, country, test and live mode and a connection test that lists the account’s payment methods.
• Uninstall keeps the payment records, refunds and the connection unless “Permanently delete all payment records on uninstall” is on.
• Job queue with retries and back-off, cron (command line and secret address), log viewer with CSV export.