SDK Java

O SDK oficial em Java 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 Java 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

Runtime	Versões aceitas
JDK	8 ou superior

HTTP via OkHttp — java.net.http.HttpClient do próprio JDK exigiria Java 11+, incompatível com o piso de Java 8 do SDK.

Instalação

Maven:

<dependency>
    <groupId>br.com.twila</groupId>
    <artifactId>parcelemais</artifactId>
    <version>1.0.0</version>
</dependency>

Gradle (Kotlin DSL):

implementation("br.com.twila:parcelemais:1.0.0")

Configuração

import twila.parcelemais.ParceleMaisClient;
import twila.parcelemais.config.ParceleMaisEnvironment;

ParceleMaisClient client = ParceleMaisClient.builder()
        .clientId("<seu-client-id>")
        .clientSecret("<seu-client-secret>")
        .environment(ParceleMaisEnvironment.STAGING)
        .build();

ParceleMaisClient é thread-safe — construa uma única instância e reaproveite como singleton na sua aplicação; feche-a só no shutdown (try-with-resources ou @Bean(destroyMethod = "close") num container de DI).

Uso

import twila.parcelemais.simulations.model.SimulateInstallmentsRequest;

var parcelas = client.simulations().simulateInstallments(
        SimulateInstallmentsRequest.builder()
                .requestedAmount(new BigDecimal("1500.00"))
                .build());

for (var parcela : parcelas)
    System.out.printf("%dx de %s%n", parcela.getTerm(), parcela.getInstallmentAmount());

O client expõe um método 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) {
    System.out.printf("Erro da API (%d, %s): %s%n", ex.getStatusCode(), ex.getErrorCode(), ex.getMessage());
}

Validando assinatura de webhooks

import twila.parcelemais.webhooks.ParceleMaisWebhookEvent;

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

Exemplos completos

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

Java puro

parcelemais-sample-plain — sem framework, main() standalone.

Spring Boot

parcelemais-sample-spring-boot — ParceleMaisClient como @Bean singleton.

Visão geral

Oficiais

Código-fonte no GitHub

Compatibilidade

Instalação

Configuração

Uso

Tratamento de erros

Validando assinatura de webhooks

Exemplos completos

Java puro

Spring Boot

Código-fonte no GitHub

​Compatibilidade

​Instalação

​Configuração

​Uso

​Tratamento de erros

​Validando assinatura de webhooks

​Exemplos completos

Java puro

Spring Boot

Compatibilidade

Instalação

Configuração

Uso

Tratamento de erros

Validando assinatura de webhooks

Exemplos completos