fragosoftware/pagarme-sdk

A Domain-Driven Design (DDD) SDK for integrating with the Pagar.me API.

v1.0.0 2025-03-07 15:16 UTC

Requires

• php: ^7.0
• guzzlehttp/guzzle: ^5.3.3|^6.2.1|^7.0
• guzzlehttp/promises: ^1.0 || ^2.0
• guzzlehttp/psr7: ^1.4.1
• nesbot/carbon: ^1.39
• symfony/console: ^2.7.51
• symfony/http-foundation: ^2.7.51
• vlucas/phpdotenv: ^1

Requires (Dev)

• phpunit/phpunit: ^5.7.27

MIT

README

Este SDK fornece uma integração estruturada com a API do Pagar.me usando Domain-Driven Design (DDD). Compatível com PHP 7.0+, foi projetado para gerenciar objetos como Cliente, Pedido e Cartão.

Estrutura do Projeto

• Application: Serviços e DTOs para lógica de negócio e transferência de dados.
• Domain: Entidades principais, Objetos de Valor e Interfaces de Repositório.
• Infrastructure: Repositórios e cliente HTTP para interações com a API.
• Interfaces: Controladores HTTP e comandos CLI para interações externas.
• Support: Funções auxiliares e classes para tarefas comuns.

Configuração

1. Clone o repositório:

   git clone https://github.com/seuusuario/pagarme-php-sdk 

1. Instale as dependências (se usando Composer):

    composer install

1. Configure as variáveis de ambiente no .env do projeto:

PAGARME_BASE_URL=https://api.pagar.me
PAGARME_API_VERSION=core/v5
PAGARME_STORE_ACCESS_TOKEN=seu_token_de_acesso

Uso

1. Instancie OrderDTO com os dados necessários do pedido.
2. Use OrderService para enviar o pedido ao Pagar.me.

use FragosoSoftware\PagarmeSdk\Application\Services\OrderService;
use FragosoSoftware\PagarmeSdk\Application\DTO\OrderDTO;

$orderDTO = new OrderDTO($customer, $items, $payments);
$orderService = new OrderService($orderRepository);
$response = $orderService->execute($orderDTO);

Contribuição

Contribuições são bem-vindas! Envie um pull request ou abra uma issue.

Licença

Este projeto é licenciado sob a Licença MIT.