SDK .NET - Parcele+

O SDK oficial em .NET encapsula autenticação, renovação de token, política de retry/circuit breaker e serialização, para que você chame a API do Parcele+ a partir de código C# sem lidar diretamente com HTTP.

Código-fonte no GitHub

Repositório público — código, exemplos (samples/) e histórico de versões.

Compatibilidade

Target Framework	Suporte
.NET Standard 2.0	✅ (.NET Framework 4.6.2+, .NET Core 2.0+)
.NET 8	✅

Instalação

dotnet add package ParceleMais

Configuração

using ParceleMais;
using ParceleMais.Configuration;
using ParceleMais.DependencyInjection;

services.AddParceleMais(options =>
{
    options.ClientId = "<seu-client-id>";
    options.ClientSecret = "<seu-client-secret>";
    options.Environment = ParceleMaisEnvironment.Staging;
});

Uso

var client = provider.GetRequiredService<IParceleMaisClient>();

var parcelas = await client.Simulations.SimulateInstallmentsAsync(
    new SimulateInstallmentsRequest(valor: 1500.00m));

foreach (var parcela in parcelas)
    Console.WriteLine($"{parcela.Term}x de {parcela.InstallmentAmount:C}");

O IParceleMaisClient expõe um cliente por recurso:

Cliente	Recurso
`client.Orders`	Pedidos (criar, consultar, listar, iniciar venda CDC, importar nota fiscal)
`client.Simulations`	Simulação de parcelas e valores
`client.Customers`	Clientes (consultar, listar)
`client.Webhooks`	Webhooks (criar, listar, atualizar, remover)

Tratamento de erros

Exceções são tipadas por categoria: ParceleMaisAuthenticationException, ParceleMaisValidationException, ParceleMaisRateLimitException, ParceleMaisTimeoutException, e a base ParceleMaisApiException para os demais erros de API.

catch (ParceleMaisApiException ex)
{
    Console.WriteLine($"Erro da API ({ex.StatusCode}, {ex.ErrorCode}): {ex.Message}");
}

Validando assinatura de webhooks

using ParceleMais.Webhooks;

var evento = ParceleMaisWebhookEvent.Parse(rawJson, signatureHeader, signingSecret);

Exemplos completos

O repositório inclui samples prontos para rodar em samples/:

Console

ParceleMais.Sample.Console — .NET 8, DI standalone.

ASP.NET Core

ParceleMais.Sample.AspNetCore — .NET 8, minimal API.

.NET Framework

ParceleMais.Sample.NetFramework — net472, ServiceCollection standalone.

Código-fonte no GitHub

​Compatibilidade

​Instalação

​Configuração

​Uso

​Tratamento de erros

​Validando assinatura de webhooks

​Exemplos completos