PHPackages                             bob-payments/sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. bob-payments/sdk

ActiveLibrary[Payment Processing](/categories/payments)

bob-payments/sdk
================

SDK oficial PHP da Bob

v1.3.0(3w ago)02[1 PRs](https://github.com/BobPayments/bob-payments-sdk-php/pulls)proprietaryPHPPHP >=8.1CI passing

Since Jul 9Pushed 3w agoCompare

[ Source](https://github.com/BobPayments/bob-payments-sdk-php)[ Packagist](https://packagist.org/packages/bob-payments/sdk)[ Docs](https://docs.payments.bob.company)[ RSS](/packages/bob-payments-sdk/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (4)Dependencies (4)Versions (7)Used By (0)

 [![Bob Payments](assets/bob-logo.png)](assets/bob-logo.png)

Bob Payments · SDK PHP
======================

[](#bob-payments--sdk-php)

 SDK oficial PHP da Bob.
 Crie uma transação em produção com meia dúzia de linhas.

 [![CI](https://github.com/BobPayments/bob-payments-sdk-php/actions/workflows/ci.yml/badge.svg)](https://github.com/BobPayments/bob-payments-sdk-php/actions/workflows/ci.yml) [![Release](https://github.com/BobPayments/bob-payments-sdk-php/actions/workflows/release.yml/badge.svg)](https://github.com/BobPayments/bob-payments-sdk-php/actions/workflows/release.yml) [![PHP >= 8.1](https://camo.githubusercontent.com/f77b2db5c3d509fa0cdc07060ddad7da5c53082540d9777cd85c6c44db1266a9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d254532253839254135382e312d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/f77b2db5c3d509fa0cdc07060ddad7da5c53082540d9777cd85c6c44db1266a9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d254532253839254135382e312d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465) [![Zero dependências](https://camo.githubusercontent.com/1bea7752fdb1b1b0ad60a1bb028914bb71c296a36cd17e4e30ebe9dd730c8484/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646570732d7a65726f2d626c756576696f6c6574)](https://camo.githubusercontent.com/1bea7752fdb1b1b0ad60a1bb028914bb71c296a36cd17e4e30ebe9dd730c8484/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646570732d7a65726f2d626c756576696f6c6574) [![PHPStan level 9](https://camo.githubusercontent.com/6154a59969be51523a8ea221cd414fa1b76d1c533b97e3de05df995a50faa0ad/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230392d344635423933)](https://camo.githubusercontent.com/6154a59969be51523a8ea221cd414fa1b76d1c533b97e3de05df995a50faa0ad/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230392d344635423933)

 [**📚 Documentação completa → docs.payments.bob.company**](https://docs.payments.bob.company/)

---

Instalação
----------

[](#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
---------------------

[](#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']; // Código de pagamento, 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
----------------

[](#por-que-este-sdk)

🪶 **Zero dependências**`ext-curl` nativo. Nada para conflitar com o seu `composer.lock`.🔁 **Idempotência automática**Todo `create` envia `Idempotency-Key` e faz retry seguro em timeout/rede/5xx — **sem risco de transação duplicada**.🔐 **Webhooks verificados**Assinatura HMAC em tempo constante (`hash_equals`), com proteção anti-replay (payload v2).🧪 **Sandbox de verdade**`sk_test_` + gateway Bob Sandbox: pague, expire ou deixe pendente controlando os centavos do valor.🐘 **PHP moderno**PHP 8.1+, `strict_types`, PHPStan level 9, transporte injetável para testes.⚠️ **Erros úteis**`ApiException` com os campos RFC 7807 da API (`status`, `errorCode`, `detail`, `retryAfterSeconds`).Documentação
------------

[](#documentação)

A referência completa vive em **[docs.payments.bob.company](https://docs.payments.bob.company/)**:

GuiaO que você encontra[Primeiros passos](https://docs.payments.bob.company/)API keys, ambientes live/sandbox, primeira cobrança[Transações](https://docs.payments.bob.company/)`create` / `get` / `list`, filtros, idempotência, HTTP 202[Checkout hospedado](https://docs.payments.bob.company/)Sessões de checkout, redirect, polling de status[Cartão de crédito](https://docs.payments.bob.company/)Tokenização (Bob Secure Fields), parcelas, 3-D Secure[Webhooks](https://docs.payments.bob.company/)Eventos, verificação de assinatura, payload v1 vs v2[Sandbox](https://docs.payments.bob.company/)Valores mágicos e fluxo de teste ponta a ponta[Erros](https://docs.payments.bob.company/)Catálogo de códigos e como tratar cada umGuia detalhado do SDK: [`docs/GUIA.md`](docs/GUIA.md).

Desenvolvimento
---------------

[](#desenvolvimento)

```
composer install && composer test   # PHPUnit · composer phpstan
```

Releases são automatizadas por [semantic-release](https://semantic-release.gitbook.io/) — commits [Conventional Commits](https://www.conventionalcommits.org/) na `main` geram versão, CHANGELOG e GitHub Release. A distribuição é via [Packagist](https://packagist.org/), que acompanha as tags do repositório.

---

 Feito com 🖤 pela equipe [Bob Payments](https://payments.bob.company)

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance95

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 69.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~8 days

Total

4

Last Release

23d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/996d7ec8d2f7e3f213f8845ee69207b0db96613f7c92bfeb034203e1f897b911?d=identicon)[bob-company](/maintainers/bob-company)

---

Top Contributors

[![brunomaarts](https://avatars.githubusercontent.com/u/20291077?v=4)](https://github.com/brunomaarts "brunomaarts (9 commits)")[![semantic-release-bot](https://avatars.githubusercontent.com/u/32174276?v=4)](https://github.com/semantic-release-bot "semantic-release-bot (4 commits)")

---

Tags

sdkpaymentsbob-payments

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/bob-payments-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/bob-payments-sdk/health.svg)](https://phpackages.com/packages/bob-payments-sdk)
```

###  Alternatives

[tatter/stripe

Stripe SDK integration for CodeIgniter 4

115.3k](/packages/tatter-stripe)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)