SDK .NET

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

O pacote publica dois target frameworks: netstandard2.0 e net8.0 (build nativo, com as dependências mais recentes).

Runtime	Versões aceitas
.NET / .NET Core	2.0 até a versão mais recente (5, 6, 7, 8, 9, 10) — via `netstandard2.0` a partir de 2.0, nativamente a partir da 8
.NET Framework	4.6.2 ou superior
Xamarin / Mono / UWP	Qualquer versão compatível com .NET Standard 2.0

.NET Core 1.0 e 1.1 não são suportados — essas versões só implementam .NET Standard 1.6, e o SDK exige .NET Standard 2.0.

Instalação

dotnet add package Twila.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.Establishments`	Lojas (cadastrar, consultar, listar, editar, trocar conta bancária, ativar/inativar)
`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.

Visão geral

Oficiais

Código-fonte no GitHub

Compatibilidade

Instalação

Configuração

Uso

Tratamento de erros

Validando assinatura de webhooks

Exemplos completos

Console

ASP.NET Core

.NET Framework

Código-fonte no GitHub

​Compatibilidade

​Instalação

​Configuração

​Uso

​Tratamento de erros

​Validando assinatura de webhooks

​Exemplos completos

Console

ASP.NET Core

.NET Framework

Compatibilidade

Instalação

Configuração

Uso

Tratamento de erros

Validando assinatura de webhooks

Exemplos completos