SplatDev.Payments 1.0.2

SplatDev.Payments

Pure payment abstractions for .NET — defines interfaces for payments, transactions, payers, cards, subscriptions, shipments, and orders. Zero dependencies, provider-agnostic. Used as the foundation for all SplatDev payment provider implementations (Stripe, MercadoPago, PagSeguro, Getnet, Santander, BancoInter).

Compatibility

Installation

dotnet add package SplatDev.Payments

Abstractions

IPayment — Base payment interface

using SplatDev.Payments.Interfaces;

public class MyPaymentProvider : IPayment
{
    public async Task<PaymentResult> CreatePaymentRequestAsync(
        IPayer payer,
        decimal amount,
        string currency,
        CancellationToken ct = default)
    {
        // Implement payment creation
    }

    public async Task<Transaction> GetTransactionAsync(
        string transactionId,
        CancellationToken ct = default)
    {
        // Implement transaction retrieval
    }

    public async Task<Transaction> ConfirmTransationAsync(
        string transactionId,
        CancellationToken ct = default)
    {
        // Implement transaction confirmation
    }
}

IPayment<T> — Generic payment interface

using SplatDev.Payments.Interfaces;

// Typed payment with provider-specific configuration
public class StripePayment : IPayment<StripeConfig>
{
    private readonly StripeConfig _config;

    public StripePayment(StripeConfig config)
    {
        _config = config;
    }

    public async Task<PaymentResult> CreatePaymentRequestAsync(
        IPayer payer,
        decimal amount,
        string currency,
        CancellationToken ct = default)
    {
        // Use _config.ApiKey, _config.WebhookSecret, etc.
    }

    // ... other IPayment members
}

Usage

Implement a custom payment provider

using SplatDev.Payments;
using SplatDev.Payments.Interfaces;

public class CustomProvider : IPayment
{
    public async Task<PaymentResult> CreatePaymentRequestAsync(
        IPayer payer,
        decimal amount,
        string currency,
        CancellationToken ct = default)
    {
        // Call the provider's API
        var response = await _httpClient.PostAsync(...);

        return new PaymentResult
        {
            Success = true,
            TransactionId = response.TransactionId,
            Status = PaymentStatus.Pending,
            RedirectUrl = response.CheckoutUrl
        };
    }

    public async Task<Transaction> GetTransactionAsync(
        string transactionId,
        CancellationToken ct = default)
    {
        // Query transaction status
    }

    public async Task<Transaction> ConfirmTransationAsync(
        string transactionId,
        CancellationToken ct = default)
    {
        // Confirm/capture the transaction
    }
}

Register in DI

// Program.cs
builder.Services.AddScoped<IPayment, CustomProvider>();

// Inject into a controller
public class CheckoutController : Controller
{
    private readonly IPayment _payment;

    public CheckoutController(IPayment payment)
    {
        _payment = payment;
    }

    [HttpPost]
    public async Task<IActionResult> Pay([FromBody] CheckoutRequest request)
    {
        var payer = new Payer
        {
            Name = request.CustomerName,
            Email = request.CustomerEmail,
            Card = new Card
            {
                Number = request.CardNumber,
                ExpirationMonth = request.ExpMonth,
                ExpirationYear = request.ExpYear
            }
        };

        var result = await _payment.CreatePaymentRequestAsync(
            payer, request.Amount, request.Currency);

        return result.Success
            ? Redirect(result.RedirectUrl!)
            : BadRequest(result.ErrorMessage);
    }
}

Features

• Zero dependencies — pure C# interfaces, no external NuGet packages
• IPayment — base payment operations: CreatePaymentRequestAsync, GetTransactionAsync, ConfirmTransationAsync
• IPayment<T> — generic variant for provider-specific configuration types
• IPayer — abstraction for payer data (name, email, address, card)
• ICard — card details (number, expiration, CVV, holder)
• ISubscription — recurring payment definitions with billing intervals
• IShipment — shipping and fulfillment data
• IOrder — order tracking and line items
• IPaymentMethod — payment method abstraction (credit card, boleto, PIX, etc.)
• Provider-agnostic — works with any payment gateway implementation

Provider Implementations

The following packages implement SplatDev.Payments abstractions:

Core Interfaces

Dependencies

None — this is a pure abstractions package with no external dependencies.

SplatDev.Payments — 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.