SplatDev.Payments.Getnet 1.0.4

SplatDev.Payments.Getnet

Getnet (Santander's card acquirer) payment SDK for .NET — OAuth2 client_credentials + HTTP Basic auth, no client certificate (distinct from SplatDev.Payments.Santander, which is the mTLS Open Banking SDK).

Targets both net8.0 (Umbraco 13) and net10.0 (Umbraco 17). Transport-only; the Umbraco webhook/backoffice controllers and dashboard live in SplatDev.Umbraco.Plugins.Getnet, and RISIN-specific orchestration stays in the consuming app.

Compatibility

Installation

dotnet add package SplatDev.Payments.Getnet

Key Types

Quick Start

Register in Program.cs:

builder.Services.Configure<GetnetApiOptions>(builder.Configuration.GetSection("Getnet"));
builder.Services.AddHttpClient<GetnetApiClient>();

Configure appsettings.json:

{
  "Getnet": {
    "BaseUrl": "https://api-sandbox.getnet.com.br",
    "SellerId": "your-seller-id",
    "ClientId": "your-client-id",
    "ClientSecret": "your-client-secret"
  }
}

Known Limitations

• Dev mock mode returns static responses; not suitable for integration testing.
• This is a transport-only SDK — payment orchestration (idempotency, retry, webhook handling) must be implemented in the consuming application.

Changelog

1.0.4 — 2026-08-25

Fixes two defects in the Getnet client. Escaping a seller or order id that contains a control character produced a request body that was not valid JSON, so the call failed; the whole character set is escaped properly now. And the API client is registered as a singleton rather than per request, so the OAuth token it caches survives to be reused instead of every call re-authenticating.

1.0.3 — 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.2 — 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.1 — 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.

License

MIT © SplatDev