danielsmelo / pagarme
Esse pacote existe devido à necessidade de integração de um projeto de terceiro com o pagar.me. Não existe nenhum vínculo do desenvolvedor desta SDK com a empresa pagar.me.
Requires
- php: ^8.1
- guzzlehttp/guzzle: ^7.7
- illuminate/contracts: ^10.0
- spatie/laravel-package-tools: ^1.14.0
Requires (Dev)
- laravel/pint: ^1.0
- nunomaduro/collision: ^7.9
- nunomaduro/larastan: ^2.0.1
- orchestra/testbench: ^8.0
- pestphp/pest: ^2.0
- pestphp/pest-plugin-arch: ^2.0
- pestphp/pest-plugin-laravel: ^2.0
- phpstan/extension-installer: ^1.1
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-phpunit: ^1.0
README
Esse pacote existe devido à necessidade de integração de um projeto de terceiro com o pagar.me. Não existe nenhum vínculo do desenvolvedor desta SDK com a empresa pagar.me
Instalação
Você pode instalar o pacote via composer.
composer require danielsmelo/pagarme
Você pode publicar o arquivo de configuração com:
php artisan vendor:publish --tag="pagarme-config"
Estes são os conteúdos do arquivo de configuração publicado:
return [ 'api_key' => 'sua_api_key', 'base_url' => 'https://api.pagar.me/core', 'api_version' => 'v5', ];
Uso
Cada função corresponde a um endpoint da API disponibilizada pelo pagar.me (https://api.pagar.me/core/v5).
Customers
Rota: POST /customers
Função:
Pagarme::client()->create(array $data)
Descrição: Cria um novo cliente com base nos dados fornecidos.
Rota: GET /customers/{id}
Função:
Pagarme::client()->find(string $id)
Descrição: Obtém as informações de um cliente específico com base no ID.
Rota: PUT /customers/{id}
Função:
Pagarme::client()->update(string $id, array $data)
Descrição: Atualiza as informações de um cliente específico com base no ID e nos novos dados fornecidos.
Rota: GET /customers
Função:
Pagarme::client()->all()
Descrição: Obtém uma lista de todos os clientes cadastrados.
Rota: POST /customers/{id}/cards
Função:
Pagarme::client()->createCreditCard(string $id, array $data)
Descrição: Cria um novo cartão de crédito associado a um cliente específico com base no ID e nos dados do cartão.
Rota: GET /customers/{id}/cards/{cardId}
Função:
Pagarme::client()->findCreditCard(string $id, string $cardId)
Descrição: Obtém as informações de um cartão de crédito específico associado a um cliente com base nos IDs do cliente e do cartão.
Rota: GET /customers/{id}/cards
Função:
Pagarme::client()->allCreditCards(string $id)
Descrição: Obtém uma lista de todos os cartões de crédito associados a um cliente específico com base no ID do cliente.
Rota: PUT /customers/{id}/cards/{cardId}
Função:
Pagarme::client()->updateCreditCard(string $id, $cardId, array $data)
Descrição: Atualiza as informações de um cartão de crédito específico associado a um cliente com base nos IDs do cliente e do cartão, e nos novos dados fornecidos.
Rota: DELETE /customers/{id}/cards/{cardId}
Função:
Pagarme::client()->deleteCreditCard(string $id, string $cardId)
Descrição: Exclui um cartão de crédito específico associado a um cliente com base nos IDs do cliente e do cartão.
Rota: POST /customers/{id}/cards/{cardId}/renew
Função:
Pagarme::client()->renewCreditCard(string $id, string $cardId)
Descrição: Renova um cartão de crédito específico associado a um cliente com base nos IDs do cliente e do cartão.
Rota: POST /customers/{id}/addresses
Função:
Pagarme::client()->createAddress(string $id, array $data)
Descrição: Cria um novo endereço associado a um cliente específico com base no ID fornecido e nos dados do endereço.
Rota: GET /customers/{id}/addresses/{addressId}
Função:
Pagarme::client()->findAddress(string $id, string $addressId)
Descrição: Obtém as informações de um endereço específico associado a um cliente com base nos IDs do cliente e do endereço.
Rota: GET /customers/{id}/addresses
Função:
Pagarme::client()->allAddresses(string $id)
Descrição: Obtém uma lista de todos os endereços associados a um cliente específico com base no ID do cliente.
Rota: PUT /customers/{id}/addresses/{addressId}
Função:
Pagarme::client()->updateAddress(string $id, $addressId, array $data)
Descrição: Atualiza as informações de um endereço específico associado a um cliente com base nos IDs do cliente e do endereço, e nos novos dados fornecidos.
Rota: DELETE /customers/{id}/addresses/{addressId}
Função:
Pagarme::client()->deleteAddress(string $id, string $addressId)
Descrição: Exclui um endereço específico associado a um cliente com base nos IDs do cliente e do endereço.
Charge
Rota: POST /charges/{id}/capture
Função:
Pagarme:charge()->capture(string $id, array $data)
Descrição: Captura um pagamento pendente associado a uma cobrança específica com base no ID da cobrança e nos dados fornecidos.
Rota: POST /charges
Função:
Pagarme:charge()->create(array $data)
Descrição: Cria uma nova cobrança com base nos dados fornecidos.
Rota: GET /charges/{id}
Função:
Pagarme:charge()->find(string $id)
Descrição: Obtém as informações de uma cobrança específica com base no ID.
Rota: PUT /charges/{id}/card
Função:
Pagarme:charge()->editCard(string $id, array $data)
Descrição: Edita as informações do cartão associado a uma cobrança específica com base no ID da cobrança e nos novos dados fornecidos.
Rota: PUT /charges/{id}/due-date
Função:
Pagarme:charge()->dueDate(string $id, array $data)
Descrição: Atualiza a data de vencimento de uma cobrança específica com base no ID da cobrança e na nova data de vencimento.
Rota: PUT /charges/{id}/payment-method
Função:
Pagarme:charge()->updatePaymentMethod(string $id, array $data)
Descrição: Atualiza o método de pagamento associado a uma cobrança específica com base no ID da cobrança e nos novos dados do método de pagamento.
Rota: DELETE /charges/{id}
Função:
Pagarme:charge()->cancel(string $id)
Descrição: Cancela uma cobrança específica com base no ID.
Rota: GET /charges
Função:
Pagarme:charge()->all()
Descrição: Obtém uma lista de todas as cobranças.
Rota: POST /charges/{id}/retry
Função:
Pagarme:charge()->retry(string $id)
Descrição: Tenta novamente realizar um pagamento para uma cobrança específica que tenha falhado anteriormente, com base no ID da cobrança.
Rota: POST /charges/{id}/confirm-payment
Função:
Pagarme:charge()->confirmCash(string $id, array $data)
Descrição: Confirma o pagamento em dinheiro associado a uma cobrança específica com base no ID da cobrança e nos dados fornecidos.
Order
Rota: POST /orders
Função:
Pagarme:order()->create(array $data)
Descrição: Cria um novo pedido com base nos dados fornecidos.
Rota: GET /orders/{id}
Função:
Pagarme:order()->find(string $id)
Descrição: Obtém as informações de um pedido específico com base no ID.
Rota: POST /orders/{id}/closed
Função:
Pagarme:order()->close(string $id)
Descrição: Fecha um pedido específico com base no ID.
Rota: GET /orders
Função:
Pagarme:order()->all()
Descrição: Obtém uma lista de todos os pedidos.
Rota: POST /orders/{id}/items
Função:
Pagarme:order()->addItem(string $id, array $data)
Descrição: Adiciona um novo item a um pedido específico com base no ID do pedido fornecido e nos dados do item.
Rota: PUT /orders/{id}/items/{itemId}
Função:
Pagarme:order()->updateItem(string $id, string $itemId, array $data)
Descrição: Atualiza as informações de um item específico associado a um pedido com base nos IDs do pedido e do item, e nos novos dados fornecidos.
Rota: DELETE /orders/{id}/items/{itemId}
Função:
Pagarme:order()->deleteItem(string $id, string $itemId)
Descrição: Exclui um item específico associado a um pedido com base nos IDs do pedido e do item.
Rota: DELETE /orders/{id}/items
Função:
Pagarme:order()->deleteAllItems(string $id)
Descrição: Exclui todos os itens associados a um pedido específico com base no ID do pedido.
Rota: GET /orders/{id}/items
Função:
Pagarme:order()->allItems(string $id)
Descrição: Obtém uma lista de todos os itens associados a um pedido específico com base no ID do pedido.
Recipients
Rota: POST /recipients
Função:
Pagarme:recipent()->create(array $data)
Descrição: Cria um novo destinatário com base nos dados fornecidos.
Rota: GET /recipients/{id}
Função:
Pagarme:recipent()->find(string $id)
Descrição: Obtém as informações de um destinatário específico com base no ID.
Rota: PUT /recipients/{id}
Função:
Pagarme:recipent()->update(string $id, array $data)
Descrição: Atualiza as informações de um destinatário específico com base no ID e nos novos dados fornecidos.
Rota: GET /recipients
Função:
Pagarme:recipent()->all()
Descrição: Obtém uma lista de todos os destinatários.
Changelog
Por favor, consulte CHANGELOG para mais informações sobre o que foi alterado recentemente.
Credits
License
Licença MIT (MIT). Por favor, consulte o Arquivo de Licença para mais informações.