Download the PHP package pagarme/pagarme-php without Composer
On this page you can find all versions of the php package pagarme/pagarme-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pagarme/pagarme-php
More information about pagarme/pagarme-php
Files in pagarme/pagarme-php
Package pagarme-php
Short Description Pagar.Me PHP Library
License MIT
Homepage http://pagar.me
Informations about the package pagarme-php
Introdução
Essa SDK foi construída com o intuito de torná-la flexível, de forma que todos possam utilizar todas as features, de todas as versões de API.
Você pode acessar a documentação oficial do Pagar.me acessando esse link.
Índice
- Instalação
- Configuração
- Transações
- Criando uma transação
- Capturando uma transação
- Estornando uma transação
- Estornando uma transação parcialmente
- Estornando uma transação com split
- Retornando transações
- Retornando uma transação
- Retornando recebíveis de uma transação
- Retornando um recebível de uma transação
- Retornando o histórico de operações de uma transação
- Notificando cliente sobre boleto a ser pago
- Retornando eventos de uma transação
- Calculando Pagamentos Parcelados
- Testando pagamento de boletos
- Estornos
- Chargebacks
- Cartões
- Criando cartões
- Retornando cartões
- Retornando um cartão
- Planos
- Criando planos
- Retornando planos
- Retornando um plano
- Atualizando um plano
- Assinaturas
- Criando assinaturas
- Split com assinatura
- Retornando uma assinatura
- Retornando assinaturas
- Atualizando uma assinatura
- Cancelando uma assinatura
- Transações de assinatura
- Pulando cobranças
- Postbacks
- Retornando postbacks
- Retornando um postback
- Reenviando um Postback
- Saldo do recebedor principal
- Operações de saldo
- Histórico das operações
- Histórico de uma operação específica
- Recebível
- Retornando recebíveis
- Retornando um recebível
- Transferências
- Criando uma transferência
- Retornando transferências
- Retornando uma transferência
- Cancelando uma transferência
- Antecipações
- Criando uma antecipação
- Obtendo os limites de antecipação
- Cancelando uma antecipação pending
- Retornando antecipações
- Contas bancárias
- Criando uma conta bancária
- Retornando uma conta bancária
- Retornando contas bancárias
- Recebedores
- Criando um recebedor
- Retornando recebedores
- Retornando um recebedor
- Atualizando um recebedor
- Saldo de um recebedor
- Operações de saldo de um recebedor
- Operação de saldo específica de um recebedor
- Clientes
- Criando um cliente
- Retornando clientes
- Retornando um cliente
- Links de pagamento
- Criando um link de pagamento
- Retornando links de pagamento
- Retornando um link de pagamento
- Cancelando um link de pagamento
- Buscas avançadas (Elasticsearch)
- Realizando uma busca
Instalação
Instale a biblioteca utilizando o comando
composer require pagarme/pagarme-php
Configuração
Para incluir a biblioteca em seu projeto, basta fazer o seguinte:
Definindo headers customizados
- Se necessário for é possível definir headers http customizados para os requests. Para isso basta informá-los durante a instanciação do objeto
Client
:
E então, você pode poderá utilizar o cliente para fazer requisições ao Pagar.me, como nos exemplos abaixo.
Transações
Nesta seção será explicado como utilizar transações no Pagar.me com essa biblioteca.
Criando uma transação
Capturando uma transação
Estornando uma transação
Esta funcionalidade também funciona com estornos parciais, ou estornos com split. Por exemplo:
Estornando uma transação parcialmente
Estornando uma transação com split
Retornando transações
Se necessário, você pode utilizar parâmetros para filtrar essa busca, por exemplo, se quiser filtrar apenas transações pagas, você pode utilizar o código abaixo:
Retornando uma transação
Retornando recebíveis de uma transação
Retornando um recebível de uma transação
Retornando o histórico de operações de uma transação
Notificando cliente sobre boleto a ser pago
Retornando eventos de uma transação
Calculando pagamentos parcelados
Essa rota não é obrigatória para uso. É apenas uma forma de calcular pagamentos parcelados com o Pagar.me.
Para fins de explicação, utilizaremos os seguintes valores:
amount
: 1000,
free_installments
: 4,
max_installments
: 12,
interest_rate
: 3
O parâmetro free_installments
decide a quantidade de parcelas sem juros. Ou seja, se ele for preenchido com o valor 4
, as quatro primeiras parcelas não terão alteração em seu valor original.
Nessa rota, é calculado juros simples, efetuando o seguinte calculo:
valorTotal = valorDaTransacao ( 1 + ( taxaDeJuros numeroDeParcelas ) / 100 )
Então, utilizando os valores acima, na quinta parcela, a conta ficaria dessa maneira:
valorTotal = 1000 (1 + (3 5) / 100)
Então, o valor a ser pago na quinta parcela seria de 15% da compra, totalizando 1150.
Você pode usar o código abaixo caso queira utilizar essa rota:
Testando pagamento de boletos
Estornos
É possível visualizar todos os estornos que ocorreram em sua conta, basta utilizar o código abaixo:
Se preferir, você pode utilizar filtros para trazer apenas o estorno de uma transação em específico, por exemplo:
Chargebacks
Da mesma forma que estornos, você pode visualizar todos os chargebacks que ocorreram em sua conta.
Cartões
Sempre que você faz uma requisição através da nossa API, nós guardamos as informações do portador do cartão, para que, futuramente, você possa utilizá-las em novas cobranças, ou até mesmo implementar features como one-click-buy.
Criando cartões
Retornando cartões
Se necessário, você pode filtrar por algum dado específico do cartão, por exemplo, o código abaixo irá trazer todos os cartões da bandeira visa:
Retornando um cartão
Planos
Representa uma configuração de recorrência a qual um cliente consegue assinar. É a entidade que define o preço, nome e periodicidade da recorrência
Criando planos
Retornando planos
Retornando um plano
Atualizando um plano
Assinaturas
Criando assinaturas
Criando assinaturas utilizando _cardid
Split com assinatura
Retornando uma assinatura
Retornando assinaturas
Se necessário, você pode aplicar filtros em sua busca. Por exemplo, se quiser trazer todas as assinatura de um certo plano, você pode utilizar o código abaixo:
Atualizando uma assinatura
Cancelando uma assinatura
Transações de assinatura
Pulando cobranças
Postbacks
Ao criar uma transação ou uma assinatura você tem a opção de passar o parâmetro postback_url na requisição. Essa é uma URL do seu sistema que irá então receber notificações a cada alteração de status dessas transações/assinaturas.
Para obter informações sobre postbacks, 3 informações serão necessárias, sendo elas: model
, model_id
e postback_id
.
model
: Se refere ao objeto que gerou aquele POSTback. Pode ser preenchido com o valor transaction
ou subscription
.
model_id
: Se refere ao ID do objeto que gerou ao POSTback, ou seja, é o ID da transação ou assinatura que você quer acessar os POSTbacks.
postback_id
: Se refere à notificação específica. Para cada mudança de status de uma assinatura ou transação, é gerado um POSTback. Cada POSTback pode ter várias tentativas de entregas, que podem ser identificadas pelo campo deliveries
, e o ID dessas tentativas possui o prefixo pd_
. O campo que deve ser enviado neste parâmetro é o ID do POSTback, que deve ser identificado pelo prefixo po_
.
Retornando postbacks
Retornando um postback
Reenviando um postback
Validando uma requisição de postback
Observação: o código acima serve somente de exemplo para que o processo de validação funcione. Recomendamos que utilize ferramentas fornecidas por bibliotecas ou frameworks para recuperar estas informações de maneira mais adequada.
Saldo do recebedor principal
Para saber o saldo de sua conta, você pode utilizar esse código:
Operações de saldo
Com este objeto você pode acompanhar todas as movimentações financeiras ocorridas em sua conta Pagar.me.
Histórico das operações
Se necessário, você pode passar filtros como parâmetro, por exemplo:
Histórico de uma operação específica
Recebível
Objeto contendo os dados de um recebível. O recebível (payable) é gerado automaticamente após uma transação ser paga. Para cada parcela de uma transação é gerado um recebível, que também pode ser dividido por recebedor (no caso de um split ter sido feito).
Retornando recebíveis
Se necessário, você pode aplicar filtros na busca dos payables, por exemplo, você pode recuperar todos os payables de uma transação:
Retornando um recebível
Transferências
Transferências representam os saques de sua conta.
Criando uma transferência
Retornando transferências
Se necessário, você pode aplicar filtros em sua busca, por exemplo:
Retornando uma transferência
Cancelando uma transferência
Antecipações
Para entender o que são as antecipações, você deve acessar esse link.
Criando uma antecipação
Obtendo os limites de antecipação
Cancelando uma antecipação pending
Retornando antecipações
Se necessário, você pode aplicar filtros nessa busca, por exemplo, pelo valor antecipado:
Contas bancárias
Contas bancárias identificam para onde será enviado o dinheiro de futuros pagamentos.
Criando uma conta bancária
Retornando uma conta bancária
Retornando contas bancárias
Se quiser, você pode aplicar filtros para a busca de contas bancárias, como por exemplo, filtrar pelo código do banco:
Recebedores
Para dividir uma transação entre várias entidades, é necessário ter um recebedor para cada uma dessas entidades. Recebedores contém informações da conta bancária para onde o dinheiro será enviado, e possuem outras informações para saber quanto pode ser antecipado por ele, ou quando o dinheiro de sua conta será sacado automaticamente.
Criando um recebedor
Retornando recebedores
Se necessário, você pode aplicar filtros nessa busca. Por exemplo, se quiser retornar todos os recebedores, com transferência habilitada, você pode utilizar esse código:
Retornando um recebedor
Atualizando um recebedor
Saldo de um recebedor
Operações de saldo de um recebedor
Operação de saldo específica de um recebedor
Clientes
Clientes representam os usuários de sua loja, ou negócio. Este objeto contém informações sobre eles, como nome, e-mail e telefone, além de outros campos.