SplatDev.Payments.MercadoPago 1.0.2

SplatDev.Payments.MercadoPago

Mercado Pago payment provider for SplatDev.Payments — models, enums, request/response contracts for the Mercado Pago REST API (Payments, Subscriptions, Pix, Boleto, Cards).

Compatibility

Installation

dotnet add package SplatDev.Payments.MercadoPago

Configuration

API endpoints

using SplatDev.Payments.MercadoPago;

// API base URLs
var v1 = Constants.APIv1;  // https://api.mercadopago.com/v1/
var api = Constants.API;   // https://api.mercadopago.com/

// JSON serializer settings (snake_case, ISO 8601 dates)
var settings = Constants.API_JSON_SETTINGS;

Using Constants.API_JSON_SETTINGS ensures consistent serialization with the Mercado Pago API conventions:

• snake_case property naming (SnakeCaseNamingStrategy)
• ISO 8601 date format (yyyy-MM-ddTHH:mm:ss.fffZ)
• DefaultValueHandling.Ignore
• NullValueHandling.Ignore

Serialization helper

var json = JsonConvert.SerializeObject(payment, Constants.API_JSON_SETTINGS);
var payment = JsonConvert.DeserializeObject<Payment>(responseJson, Constants.API_JSON_SETTINGS);

Payment Methods

Models

Payments

Requests

Subscriptions

Enums

Usage

using SplatDev.Payments.MercadoPago;
using SplatDev.Payments.MercadoPago.Enum;
using SplatDev.Payments.MercadoPago.Requests;

// Card payment
var cardPayment = new CardPaymentRequest
{
    TransactionAmount = 149.90m,
    Token = "card-token-from-frontend",
    Description = "Order #1234",
    Installments = 1,
    PaymentMethodId = PaymentMethodTypes.CreditCard,
    Payer = new Payer
    {
        Email = "customer@example.com",
        Identification = new Identification
        {
            Type = IdentificationTypes.CPF,
            Number = "12345678901"
        }
    }
};

// Pix payment
var pixPayment = new PixPaymentRequest
{
    TransactionAmount = 49.90m,
    Description = "Order #5678",
    Payer = new Payer
    {
        Email = "customer@example.com",
        FirstName = "John",
        LastName = "Doe"
    }
};

// Subscription
var subscription = new SubscriptionRequest
{
    PreApprovalPlanId = "2c938084726fca480172750000000001",
    PayerEmail = "customer@example.com",
    AutoRecurring = new AutoRecurring
    {
        Frequency = 1,
        FrequencyType = FrequencyTypes.Months,
        TransactionAmount = 29.90m
    }
};

Dependencies

API Status Transitions

Pending → Approved  (captured)
Pending → InProcess → Approved
Pending → Rejected   (declined)
Pending → Cancelled  (expired/cancelled)
Approved → Refunded
Approved → ChargedBack

Limitations

• Model/contracts library. No service layer, DI extensions, or HTTP callers included.
• API access token management is the caller's responsibility.
• Webhook/IPN handling must be implemented by the consuming application.
• Only Brazilian payment methods are modeled (BRL currency).

SplatDev.Payments.MercadoPago — part of the SplatDev.Umbraco.Plugins suite. Licensed under MIT. © SplatDev Ltda.

Changelog

1.0.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.

1.0.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.

1.0.0 — 2026-08-24

This package now keeps a changelog. Earlier releases predate it and are not reconstructed here — consult the repository history for those. From this version on, every release records what changed for someone using it.