SDK PHP

O SDK oficial em PHP encapsula autenticação, renovação de token, política de retry/circuit breaker e serialização, para que você chame a API do Parcele+ 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
PHP	7.4 ou superior

Cliente síncrono, baseado em Guzzle.

Instalação

composer require twila/parcelemais

Configuração

use Twila\ParceleMais\ParceleMaisClient;
use Twila\ParceleMais\Config\ClientOptions;
use Twila\ParceleMais\Config\Environment;

$client = new ParceleMaisClient(new ClientOptions(
    '<seu-client-id>',
    '<seu-client-secret>',
    Environment::STAGING
));

ParceleMaisClient deve ser reaproveitado (não crie uma instância por requisição) — ele mantém o cache do token de acesso e o estado do circuit breaker durante o ciclo de vida do processo/worker.

Uso

use Twila\ParceleMais\Simulations\SimulateInstallmentsRequest;

$parcelas = $client->simulations->simulateInstallments(new SimulateInstallmentsRequest(1500.0));

foreach ($parcelas as $parcela) {
    echo "{$parcela->term}x de {$parcela->installmentAmount} (total {$parcela->totalAmount})" . PHP_EOL;
}

O client expõe um objeto por recurso:

Cliente	Métodos
`$client->orders`	`create`, `get`, `list`, `startCdcSale`, `importInvoice`
`$client->simulations`	`simulateInstallments`, `simulateValues`
`$client->customers`	`get`, `list`
`$client->webhooks`	`create`, `list`, `update`, `delete`

orders->list(...) e customers->list(...) retornam um PagedResult — sem auto-paginação, você controla explicitamente o avanço de página.

Tratamento de erros

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

use Twila\ParceleMais\Errors\ParceleMaisApiException;

try {
    $client->orders->get($orderId);
} catch (ParceleMaisApiException $e) {
    echo "{$e->getStatusCode()} {$e->getErrorCode()}: {$e->getMessage()}" . PHP_EOL;
}

Validando assinatura de webhooks

use Twila\ParceleMais\Webhooks\WebhookEvent;

$evento = WebhookEvent::parse($rawBody, $signatureHeader, $signingSecret);

Exemplos completos

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

Standalone

sample-cli — script sem framework.

Slim Framework

sample-slim — ParceleMaisClient como singleton na aplicação.

Visão geral

Oficiais

Código-fonte no GitHub

Compatibilidade

Instalação

Configuração

Uso

Tratamento de erros

Validando assinatura de webhooks

Exemplos completos

Standalone

Slim Framework

Código-fonte no GitHub

​Compatibilidade

​Instalação

​Configuração

​Uso

​Tratamento de erros

​Validando assinatura de webhooks

​Exemplos completos

Standalone

Slim Framework

Compatibilidade

Instalação

Configuração

Uso

Tratamento de erros

Validando assinatura de webhooks

Exemplos completos