Download the PHP package betalabs/pagarme-php without Composer
On this page you can find all versions of the php package betalabs/pagarme-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package pagarme-php
Pagar.me PHP SDK
Integração em PHP para a Pagar.me API
Índice
- Instalação e configuração
- Utilizando a SDK
- Parâmetros page e count
- 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
- 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
- Confirmando uma antecipação building
- Cancelando uma antecipação pending
- Deletando uma antecipação building
- 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
- Suporte
- Licença
- Contribuindo
Instalação e configuração
Para utilizar a biblioteca, você pode instalá-la via composer, com o comando:
Então, basta importá-la para dentro de seu arquivo e instanciar o objeto PagarMe
:
Nota: todos os exemplos listados aqui utilizam o objeto $pagarMe
instanciado acima.
Utilizando a SDK
Parâmetros page e count
$page
representa o número da página e $count
representa a quantidade de registros. Então, se você utilizar, $page = 2
e $count = 20
para buscar um objeto, serão retornados os 20~40 objetos mais recentes
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
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
Você pode visualizar todos os estornos que ocorreram em sua conta, com esse código:
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
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
Split com assinatura
Retornando uma assinatura
Retornando assinaturas
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
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
Retornando um recebível
Transferências
Transferências representam os saques de sua conta.
Criando uma transferência
Retornando transferências
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
Confirmando uma antecipação building
Cancelando uma antecipação pending
Deletando uma antecipação building
Retornando antecipações
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
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
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.
Criando um cliente
Retornando clientes
Retornando um cliente
Suporte
Se você tiver qualquer problema ou sugestão, por favor abra uma issue aqui.
Contribuindo
Veja nosso guia de contribuição antes de nos enviar sua contribuição.