PHPackages                             kaninstein/laravel-pagarme - 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. kaninstein/laravel-pagarme

ActiveLibrary[Payment Processing](/categories/payments)

kaninstein/laravel-pagarme
==========================

Complete integration with Pagar.me payment gateway (API v5) for Laravel. Supports all payment methods: Credit/Debit Card, PIX, Boleto, Voucher. Includes ABECS codes mapping and complete test simulators.

v1.0.4(4mo ago)0681MITPHPPHP ^8.2|^8.3|^8.4

Since Dec 13Pushed 4mo agoCompare

[ Source](https://github.com/kaninstein/laravel-pagarme)[ Packagist](https://packagist.org/packages/kaninstein/laravel-pagarme)[ Docs](https://github.com/kaninstein/laravel-pagarme)[ RSS](/packages/kaninstein-laravel-pagarme/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (6)Used By (1)

Laravel Pagarme
===============

[](#laravel-pagarme)

[![Latest Version on Packagist](https://camo.githubusercontent.com/73785148d10471924b05ff09fbe4086768d095c34ede9574cc00226dcd10dd50/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b616e696e737465696e2f6c61726176656c2d70616761726d652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/kaninstein/laravel-pagarme)[![Total Downloads](https://camo.githubusercontent.com/c279c70297688c51a5e23ce4023a40664d3d573136a3e8dae9b29e7429974490/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b616e696e737465696e2f6c61726176656c2d70616761726d652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/kaninstein/laravel-pagarme)[![License](https://camo.githubusercontent.com/8677c115d53674c5b6768b22cfdf5dca38edc36ecf023ba008b168f34977c048/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6b616e696e737465696e2f6c61726176656c2d70616761726d652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/kaninstein/laravel-pagarme)[![PHP Version](https://camo.githubusercontent.com/ef30fcd5452a961f3f7ec0934da39b8f3881a04c6583e3ec6e79e9699e11838c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6b616e696e737465696e2f6c61726176656c2d70616761726d652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/kaninstein/laravel-pagarme)

**Integração completa e não-oficial com o gateway de pagamento Pagar.me (API v5) para Laravel 10, 11 e 12.**

> 🚀 **Pronto para produção** • Testes automatizados • Código 100% em português • Sem dependências do SDK oficial

Características
---------------

[](#características)

- ✅ Integração direta com a API v5 da Pagarme (sem SDK oficial)
- ✅ Suporte a Laravel 10, 11 e 12
- ✅ PHP 8.2, 8.3 e 8.4
- ✅ Autenticação Basic Auth
- ✅ DTOs type-safe para estruturação de dados
- ✅ Tratamento robusto de erros com códigos ABECS
- ✅ Retry automático em falhas temporárias
- ✅ Logging configurável
- ✅ Facade para uso simplificado
- ✅ Suporte completo a todos os métodos de pagamento:
    - 💳 Cartão de Crédito
    - 💳 Cartão de Débito
    - 🔲 PIX
    - 📄 Boleto
    - 🎫 Voucher (VR, Alelo, Sodexo, Ticket)
    - 💵 Dinheiro
    - 🔐 SafetyPay
    - 🏷️ Private Label
- ✅ Suporte a todas as principais operações:
    - 👥 Customers (Clientes)
    - 📦 Orders (Pedidos)
    - 💰 Charges (Cobranças)
    - 🔔 Webhooks
    - 💳 Cards (Cartões)
    - 🏪 SubMerchant (Facilitadores de Pagamento)
    - 🔍 BIN Lookup
    - 🔐 Tokenização
- ✅ Mapeamento completo de códigos de retorno ABECS (60+ códigos)
- ✅ Helpers brasileiros para telefones e endereços
- ✅ Simuladores de teste completos para todos os métodos de pagamento
- ✅ Testes automatizados contra API real do Pagar.me

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

[](#instalação)

Você pode instalar o pacote via composer:

```
composer require kaninstein/laravel-pagarme
```

Publique o arquivo de configuração:

```
php artisan vendor:publish --tag=pagarme-config
```

Adicione suas chaves de API no arquivo `.env`:

```
PAGARME_SECRET_KEY=sk_test_sua_chave_secreta
PAGARME_PUBLIC_KEY=pk_test_sua_chave_publica
```

Configuração
------------

[](#configuração)

O arquivo de configuração `config/pagarme.php` permite customizar:

- Chaves de API (secret e public key)
- URL da API
- Timeout de requisições
- Configuração de retry
- Configurações de webhook
- Logging

Uso Básico
----------

[](#uso-básico)

### Usando a Facade

[](#usando-a-facade)

```
use Kaninstein\LaravelPagarme\Facades\Pagarme;

// Criar um cliente
$customer = Pagarme::customers()->create([
    'name' => 'João Silva',
    'email' => 'joao@example.com',
    'type' => 'individual',
    'document' => '12345678900',
    'document_type' => 'CPF',
    'phones' => [
        'mobile_phone' => [
            'country_code' => '55',
            'area_code' => '11',
            'number' => '987654321'
        ]
    ]
]);

// Listar clientes
$customers = Pagarme::customers()->list([
    'page' => 1,
    'size' => 10
]);

// Buscar cliente por ID
$customer = Pagarme::customers()->get('cus_123456');
```

### Usando DTOs

[](#usando-dtos)

```
use Kaninstein\LaravelPagarme\DTOs\CustomerDTO;
use Kaninstein\LaravelPagarme\DTOs\OrderDTO;
use Kaninstein\LaravelPagarme\DTOs\OrderItemDTO;
use Kaninstein\LaravelPagarme\DTOs\PaymentDTO;
use Kaninstein\LaravelPagarme\DTOs\CreditCardDTO;
use Kaninstein\LaravelPagarme\Facades\Pagarme;

// Criar cliente usando DTO
$customerDTO = new CustomerDTO(
    name: 'João Silva',
    email: 'joao@example.com',
    document: '12345678900',
    documentType: 'CPF',
    phones: [
        'mobile_phone' => [
            'country_code' => '55',
            'area_code' => '11',
            'number' => '987654321'
        ]
    ]
);

$customer = Pagarme::customers()->create($customerDTO->toArray());

// Criar pedido com pagamento
$item = new OrderItemDTO(
    amount: 10000, // R$ 100,00 em centavos
    description: 'Produto X',
    quantity: 1,
    code: 'PROD-001'
);

$creditCard = new CreditCardDTO(
    number: '4111111111111111',
    holderName: 'JOAO SILVA',
    holderDocument: '12345678900',
    expMonth: 12,
    expYear: 2025,
    cvv: '123'
);

$payment = PaymentDTO::creditCard(
    creditCard: $creditCard,
    installments: 1
);

$order = new OrderDTO(
    items: [$item],
    customer: $customer['id'],
    payments: [$payment]
);

$createdOrder = Pagarme::orders()->create($order->toArray());
```

### Gerenciando Pedidos

[](#gerenciando-pedidos)

```
use Kaninstein\LaravelPagarme\Facades\Pagarme;

// Criar pedido
$order = Pagarme::orders()->create([...]);

// Buscar pedido
$order = Pagarme::orders()->get('or_123456');

// Listar pedidos
$orders = Pagarme::orders()->list([
    'page' => 1,
    'size' => 20
]);

// Fechar pedido
$closedOrder = Pagarme::orders()->close('or_123456');
```

### Gerenciando Cobranças

[](#gerenciando-cobranças)

```
use Kaninstein\LaravelPagarme\Facades\Pagarme;

// Buscar cobrança
$charge = Pagarme::charges()->get('ch_123456');

// Listar cobranças
$charges = Pagarme::charges()->list();

// Tentar novamente
$charge = Pagarme::charges()->retry('ch_123456');

// Capturar cobrança
$charge = Pagarme::charges()->capture('ch_123456', [
    'amount' => 10000
]);

// Cancelar cobrança
$charge = Pagarme::charges()->cancel('ch_123456');
```

### Calculadora de Taxas (Fee Calculator)

[](#calculadora-de-taxas-fee-calculator)

Simule taxas e valores (líquido/sugerido) via endpoint `transactions/fee-calculator`, com cache por ~1 mês por padrão.

```
use Kaninstein\LaravelPagarme\Facades\Pagarme;

$result = Pagarme::feeCalculator()->calculate([
    'amount' => 7800, // centavos
    'fee_responsibility' => 'merchant', // ou 'buyer'
    'credit_card' => [
        'installments' => 1,
        'card_brand' => 'mastercard',
        'capture_method' => 'ecommerce', // opcional (default: ecommerce)
    ],
]);

// Desativar cache (por chamada)
$result = Pagarme::feeCalculator()->calculate($payload, useCache: false);
```

### Webhooks

[](#webhooks)

#### Configuração Automática (Recomendado)

[](#configuração-automática-recomendado)

Use o comando Artisan para configurar webhooks automaticamente:

```
# Configurar webhooks recomendados
php artisan pagarme:setup-webhooks

# Especificar URL customizada
php artisan pagarme:setup-webhooks --url=https://seusite.com/api/webhooks/pagarme

# Configurar eventos específicos
php artisan pagarme:setup-webhooks --events=order.paid,charge.paid

# Listar webhooks existentes
php artisan pagarme:setup-webhooks --list

# Limpar e recriar todos os webhooks
php artisan pagarme:setup-webhooks --clean
```

Configure a URL no `.env`:

```
PAGARME_WEBHOOK_URL=https://seusite.com/api/webhooks/pagarme
```

#### Configuração Manual

[](#configuração-manual)

```
use Kaninstein\LaravelPagarme\Facades\Pagarme;

// Criar webhook
$webhook = Pagarme::webhooks()->create([
    'url' => 'https://seusite.com/webhooks/pagarme',
    'events' => [
        'order.paid',
        'order.canceled',
        'charge.paid'
    ]
]);

// Listar webhooks
$webhooks = Pagarme::webhooks()->list();

// Atualizar webhook
$webhook = Pagarme::webhooks()->update('hook_123', [
    'url' => 'https://seusite.com/new-webhook-url'
]);

// Deletar webhook
Pagarme::webhooks()->delete('hook_123');
```

#### Segurança e Validação de Webhooks

[](#segurança-e-validação-de-webhooks)

**IMPORTANTE**: Pagar.me NÃO suporta validação HMAC nativamente. O pacote oferece múltiplas camadas de segurança:

##### 1. Validação por IP Whitelist (Recomendado)

[](#1-validação-por-ip-whitelist-recomendado)

Configure os IPs permitidos no `.env`:

```
# Lista de IPs separados por vírgula (suporta CIDR)
PAGARME_WEBHOOK_ALLOWED_IPS=203.0.113.0/24,198.51.100.10
```

##### 2. Middleware de Validação

[](#2-middleware-de-validação)

Adicione o middleware nas suas rotas:

```
use Kaninstein\LaravelPagarme\Middleware\ValidateWebhookSignature;

Route::post('/api/webhooks/pagarme', [WebhookController::class, 'handle'])
    ->middleware(ValidateWebhookSignature::class);
```

##### 3. Validação Manual

[](#3-validação-manual)

```
use Kaninstein\LaravelPagarme\Services\WebhookValidator;
use Illuminate\Http\Request;

class WebhookController extends Controller
{
    public function handle(Request $request)
    {
        $validator = WebhookValidator::fromConfig();

        // Validação completa (IP + estrutura)
        $result = $validator->validateWebhook($request);

        if (!$result['valid']) {
            Log::warning('Webhook inválido', $result['reasons']);
            return response()->json(['error' => 'Invalid webhook'], 401);
        }

        // Processar webhook
        $payload = $request->json()->all();

        match ($payload['type']) {
            'order.paid' => $this->handleOrderPaid($payload['data']),
            'charge.paid' => $this->handleChargePaid($payload['data']),
            'charge.refunded' => $this->handleChargeRefunded($payload['data']),
            default => Log::info('Evento não tratado: ' . $payload['type']),
        };

        return response()->json(['status' => 'processed']);
    }
}
```

##### 4. Validação por Estrutura do Payload

[](#4-validação-por-estrutura-do-payload)

```
$validator = WebhookValidator::fromConfig();

$payload = $request->json()->all();

if (!$validator->validatePayloadStructure($payload)) {
    // Payload não tem estrutura válida do Pagar.me
    return response()->json(['error' => 'Invalid payload'], 400);
}
```

#### Eventos Disponíveis

[](#eventos-disponíveis)

**Pedidos:**

- `order.paid` - Pedido pago
- `order.payment_failed` - Falha no pagamento
- `order.canceled` - Pedido cancelado
- `order.closed` - Pedido fechado

**Cobranças:**

- `charge.paid` - Cobrança paga
- `charge.payment_failed` - Falha no pagamento
- `charge.refunded` - Estorno realizado
- `charge.chargedback` - Chargeback recebido
- `charge.underpaid` - Pago a menor
- `charge.overpaid` - Pago a maior

**Antifraude:**

- `charge.antifraud_approved` - Aprovado
- `charge.antifraud_reproved` - Reprovado
- `charge.antifraud_manual` - Análise manual

Consulte a [documentação oficial](https://docs.pagar.me/reference/eventos-de-webhook-1) para lista completa.

### Facilitadores de Pagamento (SubMerchant)

[](#facilitadores-de-pagamento-submerchant)

Se você opera como **Facilitador de Pagamento (Subadquirente)**, pode configurar os dados de subcredenciado para serem enviados automaticamente em todas as transações.

**Adquirentes integradas**: Stone, GetNet, Cielo 1.5, Cielo 3, PagSeguro, ERede e SafraPay.

#### Configuração Automática via .env

[](#configuração-automática-via-env)

Configure os dados do submerchant no `.env` e eles serão incluídos automaticamente em todos os pedidos:

```
PAGARME_SUBMERCHANT_ENABLED=true
PAGARME_SUBMERCHANT_MCC=5411
PAGARME_SUBMERCHANT_FACILITATOR_CODE=123456789
PAGARME_SUBMERCHANT_CODE=STORE-001
PAGARME_SUBMERCHANT_NAME="Minha Loja"
PAGARME_SUBMERCHANT_LEGAL_NAME="Minha Empresa LTDA"
PAGARME_SUBMERCHANT_DOCUMENT=12345678000190
PAGARME_SUBMERCHANT_TYPE=company
```

#### Uso Manual com DTO

[](#uso-manual-com-dto)

```
use Kaninstein\LaravelPagarme\DTOs\SubMerchantDTO;
use Kaninstein\LaravelPagarme\DTOs\PhoneDTO;
use Kaninstein\LaravelPagarme\DTOs\AddressDTO;

$submerchant = new SubMerchantDTO(
    merchantCategoryCode: '5411', // MCC - 4 dígitos
    paymentFacilitatorCode: '123456789',
    code: 'STORE-001',
    name: 'Loja do João',
    document: '12345678000190',
    type: 'company',
    legalName: 'João Comércio LTDA',
    phone: PhoneDTO::brazilian('11', '987654321'),
    address: AddressDTO::brazilian(
        street: 'Rua Exemplo, 123',
        zipCode: '01234567',
        city: 'São Paulo',
        state: 'SP'
    )
);

// Incluir no pedido
$order = new OrderDTO(
    items: $items,
    customer: $customer,
    payments: $payments,
    submerchant: $submerchant
);
```

#### Controle por Pedido

[](#controle-por-pedido)

```
// Desabilitar submerchant para um pedido específico
// (mesmo que esteja habilitado no config)
$order->withoutSubmerchant();

// Ou definir submerchant específico para um pedido
$order->withSubmerchant($customSubmerchant);
```

Veja mais exemplos em `examples/submerchant-example.php`.

Métodos de Pagamento
--------------------

[](#métodos-de-pagamento)

### PIX

[](#pix)

```
use Kaninstein\LaravelPagarme\DTOs\PixPaymentDTO;
use Kaninstein\LaravelPagarme\DTOs\PaymentDTO;

// PIX com expiração de 1 hora
$pixPayment = PixPaymentDTO::withExpiresIn(3600);

$payment = PaymentDTO::pix($pixPayment);

$order = OrderDTO::create($items, $customer, $payment)
    ->withIp('192.168.1.1'); // IP é obrigatório para PIX

$result = Pagarme::orders()->create($order->toArray());

// QR Code estará em: $result['charges'][0]['last_transaction']['qr_code']
// QR Code URL: $result['charges'][0]['last_transaction']['qr_code_url']
```

### Boleto

[](#boleto)

```
use Kaninstein\LaravelPagarme\DTOs\BoletoPaymentDTO;
use Kaninstein\LaravelPagarme\DTOs\PaymentDTO;

$boleto = BoletoPaymentDTO::create(
    dueAt: new \DateTime('+7 days'),
    instructions: 'Não aceitar após vencimento',
    documentNumber: '123456'
);

// Adicionar multa de 2%
$boleto->withFine(2.0);

// Adicionar juros de 1% ao mês
$boleto->withInterest(1.0);

$payment = PaymentDTO::boleto($boleto);

$order = OrderDTO::create($items, $customer, $payment);
$result = Pagarme::orders()->create($order->toArray());

// URL do boleto: $result['charges'][0]['last_transaction']['url']
// Linha digitável: $result['charges'][0]['last_transaction']['line']
```

### Cartão de Débito

[](#cartão-de-débito)

```
use Kaninstein\LaravelPagarme\DTOs\DebitCardDTO;
use Kaninstein\LaravelPagarme\DTOs\DebitCardPaymentDTO;
use Kaninstein\LaravelPagarme\DTOs\PaymentDTO;

$debitCard = DebitCardDTO::fromToken($token['id']);

$payment = PaymentDTO::debitCard(
    DebitCardPaymentDTO::withCard($debitCard)
);

$order = OrderDTO::create($items, $customer, $payment);
$result = Pagarme::orders()->create($order->toArray());
```

### Voucher (Vale Alimentação/Refeição)

[](#voucher-vale-alimentaçãorefeição)

```
use Kaninstein\LaravelPagarme\DTOs\VoucherCardDTO;
use Kaninstein\LaravelPagarme\DTOs\VoucherPaymentDTO;
use Kaninstein\LaravelPagarme\DTOs\PaymentDTO;

$voucherCard = VoucherCardDTO::fromToken($token['id']);

$payment = PaymentDTO::voucher(
    VoucherPaymentDTO::withCard($voucherCard, 'RESTAURANTE')
);

$order = OrderDTO::create($items, $customer, $payment);
$result = Pagarme::orders()->create($order->toArray());
```

Marcas de voucher suportadas: **Alelo**, **Sodexo**, **Ticket**, **VR**, **Pluxee**.

Tokenização
-----------

[](#tokenização)

O pacote suporta tokenização de cartões para maior segurança. Veja o guia completo em [TOKENIZATION\_GUIDE.md](TOKENIZATION_GUIDE.md).

```
use Kaninstein\LaravelPagarme\Services\TokenService;

$tokenService = new TokenService();

// Criar token de cartão
$token = $tokenService->createCardToken([
    'number' => '4111111111111111',
    'holder_name' => 'JOAO SILVA',
    'exp_month' => 12,
    'exp_year' => 2030,
    'cvv' => '123',
]);

// Usar token no pagamento
$creditCard = CreditCardDTO::fromToken($token['id']);
```

Simuladores de Teste
--------------------

[](#simuladores-de-teste)

O pacote inclui testes completos para todos os simuladores da Pagar.me. Consulte [CODIGOS\_RETORNO.md](CODIGOS_RETORNO.md) para a lista completa de cartões de teste e cenários.

### Cartões de Teste (Crédito/Débito/Voucher)

[](#cartões-de-teste-créditodébitovoucher)

```
// Sucesso
'4000000000000010'

// Não autorizado
'4000000000000028'

// Processing → Sucesso
'4000000000000036'

// Processing → Falha
'4000000000000044'

// CVV começando com 6 → Recusa do emissor
$cvv = '6XX' // qualquer número começando com 6

// Documento 11111111111 → Bloqueio antifraude
$cpf = '11111111111'

// Valores R$ 1,30 a R$ 1,60 → Chargeback Guarantee
$amount = 130; // 130 a 160 centavos
```

### PIX - Regras de Simulação

[](#pix---regras-de-simulação)

- **Valores até R$ 500,00**: Sucesso (pending → paid)
- **Valores acima R$ 500,00**: Falha

### Boleto - Regras por CEP

[](#boleto---regras-por-cep)

- **CEP 01046010**: Pagamento a menor
- **CEP 57400000**: Pagamento a maior
- **CEP 70070300**: Não conciliado
- **Outros CEPs**: Pagamento total

Códigos de Retorno ABECS
------------------------

[](#códigos-de-retorno-abecs)

O pacote mapeia todos os códigos de retorno ABECS (Associação Brasileira das Empresas de Cartões de Crédito e Serviços) com mais de 60 códigos padronizados.

```
use Kaninstein\LaravelPagarme\Enums\AbecsReturnCode;
use Kaninstein\LaravelPagarme\Exceptions\TransactionDeclinedException;

try {
    $order = Pagarme::orders()->create([...]);
} catch (TransactionDeclinedException $e) {
    // Informações detalhadas da recusa
    $abecsCode = $e->getAbecsCode(); // Enum AbecsReturnCode
    $reason = $e->getDeclineReason(); // Mensagem em português
    $canRetry = $e->canRetry(); // Se pode tentar novamente

    // Verificações específicas
    if ($e->isFraudRelated()) {
        // Bloqueio por fraude
    }

    if ($e->isInsufficientFunds()) {
        // Saldo insuficiente
    }

    if ($e->isInvalidCard()) {
        // Cartão inválido
    }

    // Informações completas
    $info = $e->getDeclineInfo();
    // [
    //     'abecs_code' => '1002',
    //     'message' => 'Transação não autorizada - suspeita de fraude',
    //     'can_retry' => false,
    //     'acquirer_code' => 'XX',
    //     'gateway_code' => 'YY'
    // ]
}
```

### Principais Códigos ABECS

[](#principais-códigos-abecs)

CódigoDescriçãoRetry?0000Aprovado-1000Não autorizado❌1002Suspeita de fraude❌1016Saldo insuficiente❌1051Cartão vencido❌1057Transação não permitida❌1070Recusado antifraude❌9111Timeout do emissor✅Consulte [CODIGOS\_RETORNO.md](CODIGOS_RETORNO.md) para a lista completa de todos os 60+ códigos.

Tratamento de Erros
-------------------

[](#tratamento-de-erros)

O pacote lança exceções específicas para diferentes tipos de erro:

```
use Kaninstein\LaravelPagarme\Exceptions\AuthenticationException;
use Kaninstein\LaravelPagarme\Exceptions\ValidationException;
use Kaninstein\LaravelPagarme\Exceptions\NotFoundException;
use Kaninstein\LaravelPagarme\Exceptions\PagarmeException;

try {
    $customer = Pagarme::customers()->create([...]);
} catch (ValidationException $e) {
    // Erro de validação (422)
    $errors = $e->getErrors();
    $message = $e->getMessage();
} catch (AuthenticationException $e) {
    // Erro de autenticação (401)
} catch (NotFoundException $e) {
    // Recurso não encontrado (404)
} catch (PagarmeException $e) {
    // Outros erros da API
    $response = $e->getResponse();
}
```

Tipos de Exceção
----------------

[](#tipos-de-exceção)

- `BadRequestException` - Código 400
- `AuthenticationException` - Código 401
- `ForbiddenException` - Código 403
- `NotFoundException` - Código 404
- `PreconditionFailedException` - Código 412
- `ValidationException` - Código 422
- `TooManyRequestsException` - Código 429
- `PagarmeException` - Exceção base para outros erros

Injeção de Dependência
----------------------

[](#injeção-de-dependência)

Você pode injetar os services diretamente nos seus controllers:

```
use Kaninstein\LaravelPagarme\Services\CustomerService;
use Kaninstein\LaravelPagarme\Services\OrderService;

class PaymentController extends Controller
{
    public function __construct(
        private CustomerService $customerService,
        private OrderService $orderService
    ) {}

    public function createOrder()
    {
        $customer = $this->customerService->create([...]);
        $order = $this->orderService->create([...]);

        return response()->json($order);
    }
}
```

Logging
-------

[](#logging)

Para habilitar logging de requisições e respostas:

```
PAGARME_LOGGING_ENABLED=true
PAGARME_LOGGING_CHANNEL=stack
```

Testes
------

[](#testes)

```
composer test
```

Changelog
---------

[](#changelog)

Consulte [CHANGELOG](CHANGELOG.md) para mais informações sobre mudanças recentes.

Contribuindo
------------

[](#contribuindo)

Contribuições são bem-vindas! Por favor, consulte [CONTRIBUTING](CONTRIBUTING.md) para detalhes.

Segurança
---------

[](#segurança)

Se você descobrir alguma questão de segurança, por favor envie um email para  ao invés de usar o issue tracker.

Créditos
--------

[](#créditos)

- [João Pedro Coelho](https://github.com/kaninstein)

Licença
-------

[](#licença)

The MIT License (MIT). Consulte [License File](LICENSE.md) para mais informações.

Documentação Adicional
----------------------

[](#documentação-adicional)

- 📖 [TOKENIZATION\_GUIDE.md](TOKENIZATION_GUIDE.md) - Guia completo de tokenização de cartões
- 📖 [CODIGOS\_RETORNO.md](CODIGOS_RETORNO.md) - Lista completa de códigos ABECS e simuladores
- 📖 [STRUCTURE.md](STRUCTURE.md) - Estrutura do pacote e arquitetura
- 📖 [CONTRIBUTING.md](CONTRIBUTING.md) - Guia de contribuição

Roadmap
-------

[](#roadmap)

- ✅ Suporte completo a PIX
- ✅ Suporte a Boleto
- ✅ Suporte a Cartão de Débito
- ✅ Suporte a Voucher (VR, Alelo, Sodexo, Ticket)
- ✅ Mapeamento de códigos ABECS
- ✅ Testes automatizados completos
- ✅ Suporte a SubMerchant
- ✅ Tokenização de cartões
- ✅ Validação e segurança de webhooks (IP whitelist + estrutura)
- ✅ Comando Artisan para configuração automática de webhooks
- Suporte a assinaturas/recorrência
- Suporte a split de pagamentos
- Suporte a Google Pay
- Suporte a Apple Pay

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance74

Regular maintenance activity

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~2 days

Total

5

Last Release

142d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fcac76a940d26d775a054b9e6dce4fc8525894c22cb888879f3c59d78ee3f60b?d=identicon)[kaninstein](/maintainers/kaninstein)

---

Top Contributors

[![kaninstein](https://avatars.githubusercontent.com/u/90076934?v=4)](https://github.com/kaninstein "kaninstein (10 commits)")

---

Tags

laravelpaymentgatewayboletopayment gatewayvoucherbrazilcredit-cardpagar.medebit cardpixabecs

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/kaninstein-laravel-pagarme/health.svg)

```
[![Health](https://phpackages.com/badges/kaninstein-laravel-pagarme/health.svg)](https://phpackages.com/packages/kaninstein-laravel-pagarme)
```

###  Alternatives

[sebdesign/laravel-viva-payments

A Laravel package for integrating the Viva Payments gateway

4845.9k](/packages/sebdesign-laravel-viva-payments)[mrprompt/cielo

Integration with Cielo gateway.

481.9k1](/packages/mrprompt-cielo)

PHPackages © 2026

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