README

Bob Payments · SDK PHP

SDK oficial PHP da API de pagamentos PIX da Bob.
Crie uma cobrança PIX em produção com meia dúzia de linhas.

📚 Documentação completa → docs.payments.bob.company

Instalação

composer require bob-payments/sdk

Server-side only — a API key sk_live_/sk_test_ é secreta e nunca deve ir para o browser.

Requer PHP >= 8.1 com ext-curl e ext-json (presentes em praticamente qualquer instalação). Zero dependências de runtime.

Comece em 30 segundos

use BobPayments\BobPaymentsClient;

$bob = new BobPaymentsClient(['apiKey' => getenv('BOB_API_KEY')]);

$tx = $bob->transactions->create([
    'customer' => [
        'name' => 'João Silva',
        'document' => '12345678901',
        'documentType' => 'CPF',
        'email' => 'joao@example.com',
        'address' => ['street' => 'Rua das Flores', 'streetNumber' => '123', 'neighborhood' => 'Centro', 'zipCode' => '01310-100', 'city' => 'São Paulo', 'state' => 'SP'],
    ],
    'payment' => ['amountCents' => 10_000, 'product' => 'Assinatura Pro'], // R$ 100,00 — sempre centavos
    'originDomain' => 'loja.example.com',
]);

echo $tx['pixCode']; // PIX copia-e-cola, pronto para o comprador

Recebendo a confirmação de pagamento (webhook):

use BobPayments\Webhooks;

// ⚠️ use o corpo BRUTO da request — nunca o JSON re-serializado
$rawBody = file_get_contents('php://input');
$event = Webhooks::constructEvent($rawBody, $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? null, $webhookSecret);

if ($event['event'] === 'transaction.paid') {
    liberarPedido($event['data']['transactionId']); // v2: $event['data']['amountCents']
}

Por que este SDK

Documentação

A referência completa vive em docs.payments.bob.company:

Guia detalhado do SDK: docs/GUIA.md.

Desenvolvimento

composer install && composer test   # PHPUnit · composer phpstan

Releases são automatizadas por semantic-release — commits Conventional Commits na main geram versão, CHANGELOG e GitHub Release. A distribuição é via Packagist, que acompanha as tags do repositório.

Feito com 🖤 pela equipe Bob Payments