SplatDev.Umbraco.Plugins.Payments.MercadoPago 2.2.4

Payments.MercadoPago

MercadoPago payment integration for Umbraco — create payment preferences, track payment status, and handle webhook notifications via a backoffice dashboard.

Compatibility

Installation

dotnet add package SplatDev.Umbraco.Plugins.Payments.MercadoPago

Quick Start

The plugin auto-registers via MercadoPagoComposer, which sets up the EF Core DbContext, HttpClient, and IMercadoPagoService.

Configuration

Add to appsettings.json:

{
  "MercadoPago": {
    "AccessToken": "your-mercadopago-access-token",
    "PublicKey": "your-mercadopago-public-key",
    "Sandbox": true
  },
  "ConnectionStrings": {
    "umbracoDbDSN": "Server=localhost;Database=umbraco;Trusted_Connection=True;"
  }
}

Set Sandbox: true for testing, false for production. Obtain credentials from the MercadoPago Developer Dashboard.

API Endpoints

Usage

// Create a payment preference
const response = await fetch('/umbraco/api/mercadopago/CreatePreference', {
    method: 'POST',
    body: JSON.stringify({
        items: [{ title: 'Product', quantity: 1, unit_price: 99.90 }],
        external_reference: 'ORDER-001'
    }),
    headers: { 'Content-Type': 'application/json' }
});
const { preferenceId } = await response.json();

// Initialize MercadoPago checkout with the returned preferenceId
const mp = new MercadoPago('PUBLIC_KEY');
mp.checkout({ preference: { id: preferenceId } });

Known Limitations

• No built-in checkout UI — the API returns a preferenceId for client-side MercadoPago SDK integration
• The AccessToken is never exposed to the frontend (only PublicKey and Sandbox are returned by GetConfig)
• No webhook/IPN handling in the Umbraco plugin layer; actual API calls are delegated to SplatDev.Payments.MercadoPago
• Front-end integration requires the MercadoPago JavaScript SDK

Changelog

2.2.4 — 2026-08-26

The NuGet listing now shows the dashboard. It had no screenshot before, so the listing gave no picture of what the plugin looks like in the backoffice.

2.2.3 — 2026-08-26

Fixes a duplicate registration on sites that still have a physical App_Plugins folder for this plugin, left behind by an older release that copied content into the site. Umbraco registered those extensions twice - once from its own scan of the folder, once from this package's embedded manifest - and logged "Extension with alias ... is already registered". The embedded manifest now yields to the physical copy.

2.2.2 — 2026-08-24

Removes a dashboard screenshot that showed an error toast. It was captured against a site where this plugin's API was unreachable, so it advertised a broken dashboard. No screenshot is better than a misleading one; a replacement will be taken against a working install.

2.2.1 — 2026-08-24

Package metadata only: the listing now carries an icon and search tags, and the project and repository links point at the organisation that actually hosts this code. No code changes.

2.2.0 — 2026-08-23

The Umbraco Marketplace listing now shows every screenshot for this plugin, not just the dashboard. The listing keeps its own screenshot list rather than reading the README.

2.1.6 — 2026-08-21

• Dashboard now sends the backoffice token with its API calls. On Umbraco 17 those calls were arriving unauthenticated and coming back 401, which the dashboard rendered as an empty state rather than an error.
• A failed request now raises a notification instead of leaving the dashboard looking like there is simply no data.
• The plugin's tables are created on startup. They were never created before, so anything touching them failed on a fresh install.
• Runs on SQLite as well as SQL Server. It previously assumed SQL Server and failed with "Keyword not supported: 'cache'" on the database Umbraco's installer offers by default.

License

MIT © SplatDev