2017 © Pedro Peláez
 

lib pagarme-php

Pagar.Me PHP Library

image

pagarme/pagarme-php

Pagar.Me PHP Library

  • Thursday, July 26, 2018
  • by devdrops
  • Repository
  • 81 Watchers
  • 132 Stars
  • 88,922 Installations
  • PHP
  • 8 Dependents
  • 0 Suggesters
  • 92 Forks
  • 20 Open issues
  • 68 Versions
  • 12 % Grown

The README.md

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., (*1)

Você pode acessar a documentação oficial do Pagar.me acessando esse link., (*2)

Índice

Instalação

Instale a biblioteca utilizando o comando, (*3)

composer require pagarme/pagarme-php, (*4)

Configuração

Para incluir a biblioteca em seu projeto, basta fazer o seguinte:, (*5)

<?php
require('vendor/autoload.php');

$pagarme = new PagarMe\Client('SUA_CHAVE_DE_API');

Definindo headers customizados

  1. 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:
<?php
require('vendor/autoload.php');

$pagarme = new PagarMe\Client(
    'SUA_CHAVE_DE_API',
    ['headers' => ['MEU_HEADER_CUSTOMIZADO' => 'VALOR HEADER CUSTOMIZADO']]
);

E então, você pode poderá utilizar o cliente para fazer requisições ao Pagar.me, como nos exemplos abaixo., (*6)

Transações

Nesta seção será explicado como utilizar transações no Pagar.me com essa biblioteca., (*7)

Criando uma transação

<?php
$transaction = $pagarme->transactions()->create([
    'amount' => 1000,
    'payment_method' => 'credit_card',
    'card_holder_name' => 'Anakin Skywalker',
    'card_cvv' => '123',
    'card_number' => '4242424242424242',
    'card_expiration_date' => '1220',
    'customer' => [
        'external_id' => '1',
        'name' => 'Nome do cliente',
        'type' => 'individual',
        'country' => 'br',
        'documents' => [
          [
            'type' => 'cpf',
            'number' => '00000000000'
          ]
        ],
        'phone_numbers' => [ '+551199999999' ],
        'email' => 'cliente@email.com'
    ],
    'billing' => [
        'name' => 'Nome do pagador',
        'address' => [
          'country' => 'br',
          'street' => 'Avenida Brigadeiro Faria Lima',
          'street_number' => '1811',
          'state' => 'sp',
          'city' => 'Sao Paulo',
          'neighborhood' => 'Jardim Paulistano',
          'zipcode' => '01451001'
        ]
    ],
    'shipping' => [
        'name' => 'Nome de quem receberá o produto',
        'fee' => 1020,
        'delivery_date' => '2018-09-22',
        'expedited' => false,
        'address' => [
          'country' => 'br',
          'street' => 'Avenida Brigadeiro Faria Lima',
          'street_number' => '1811',
          'state' => 'sp',
          'city' => 'Sao Paulo',
          'neighborhood' => 'Jardim Paulistano',
          'zipcode' => '01451001'
        ]
    ],
    'items' => [
        [
          'id' => '1',
          'title' => 'R2D2',
          'unit_price' => 300,
          'quantity' => 1,
          'tangible' => true
        ],
        [
          'id' => '2',
          'title' => 'C-3PO',
          'unit_price' => 700,
          'quantity' => 1,
          'tangible' => true
        ]
    ]
]);

Capturando uma transação

<?php
$capturedTransaction = $pagarme->transactions()->capture([
    'id' => 'ID_OU_TOKEN_DA_TRANSAÇÃO',
    'amount' => VALOR_TOTAL_COM_CENTAVOS
]);

Estornando uma transação

<?php
$refundedTransaction = $pagarme->transactions()->refund([
    'id' => 'ID_OU_TOKEN_DA_TRANSAÇÃO',
]);

Esta funcionalidade também funciona com estornos parciais, ou estornos com split. Por exemplo:, (*8)

Estornando uma transação parcialmente

<?php
$partialRefundedTransaction = $pagarme->transactions()->refund([
    'id' => 'ID_OU_TOKEN_DA_TRANSAÇÃO',
    'amount' => 'VALOR_PARCIAL_DO_ESTORNO',
]);

Estornando uma transação com split

<?php
$refundedTransactionWithSplit = $pagarme->transactions()->refund([
    'id' => 'ID_OU_TOKEN_DA_TRANSAÇÃO',
    'amount' => '6153',
    'split_rules' => [
        [
            'id' => 'sr_cj41w9m4d01ta316d02edaqav',
            'amount' => '3000',
            'recipient_id' => 're_cj2wd5ul500d4946do7qtjrvk'
        ],
        [
            'id' => 'sr_cj41w9m4e01tb316dl2f2veyz',
            'amount' => '3153',
            'recipient_id' => 're_cj2wd5u2600fecw6eytgcbkd0',
            'charge_processing_fee' => 'true'
        ]
    ]
]);

Retornando transações

<?php
$transactions = $pagarme->transactions()->getList();

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:, (*9)

<?php
$paidTransactions = $pagarme->transactions()->getList([
    'status' => 'paid'
]);

Retornando uma transação

<?php
$transactions = $pagarme->transactions()->get([
    'id' => 'ID_DA_TRANSAÇÃO' 
]);

Retornando recebíveis de uma transação

<?php
$transactionPayables = $pagarme->transactions()->listPayables([
    'id' => 'ID_DA_TRANSAÇÃO'
]);

Retornando um recebível de uma transação

<?php
$transactionPayable = $pagarme->transactions()->getPayable([
    'transaction_id' => 'ID_DA_TRANSAÇÃO',
    'payable_id' => 'ID_DO_PAYABLE'
]);

Retornando o histórico de operações de uma transação

<?php
$transactionOperations = $pagarme->transactions()->listOperations([
    'id' => 'ID_DA_TRANSAÇÃO',
]);

Notificando cliente sobre boleto a ser pago

<?php
$transactionPaymentNotify = $pagarme->transactions()->collectPayment([
    'id' => 'ID_DA_TRANSAÇÃO',
    'email' = > 'cliente@email.com'
]);

Retornando eventos de uma transação

<?php
$transactionEvents = $pagarme->transactions()->events([
    'id' => 4262049,
]);

Calculando pagamentos parcelados

Essa rota não é obrigatória para uso. É apenas uma forma de calcular pagamentos parcelados com o Pagar.me., (*10)

Para fins de explicação, utilizaremos os seguintes valores:, (*11)

amount: 1000, free_installments: 4, max_installments: 12, interest_rate: 3, (*12)

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., (*13)

Nessa rota, é calculado juros simples, efetuando o seguinte calculo:, (*14)

valorTotal = valorDaTransacao * ( 1 + ( taxaDeJuros * numeroDeParcelas ) / 100 ), (*15)

Então, utilizando os valores acima, na quinta parcela, a conta ficaria dessa maneira:, (*16)

valorTotal = 1000 * (1 + (3 * 5) / 100), (*17)

Então, o valor a ser pago na quinta parcela seria de 15% da compra, totalizando 1150., (*18)

Você pode usar o código abaixo caso queira utilizar essa rota:, (*19)

<?php
$calculateInstallments = $pagarme->transactions()->calculateInstallments([
    'amount' => 'VALOR_DA_TRANSAÇÃO_EM_CENTAVOS',
    'free_installments' => 'PARCELAS_SEM_JUROS',
    'max_installments' => 'MÁXIMO_DE_PARCELAS',
    'interest_rate' => 'TAXA_DE_JUROS_AO_MÊS'
]);

Testando pagamento de boletos

<?php
$paidBoleto = $pagarme->transactions()->simulateStatus([
    'id' => 'ID_DA_TRANSAÇÃO',
    'status' => 'paid'
]);

Estornos

É possível visualizar todos os estornos que ocorreram em sua conta, basta utilizar o código abaixo:, (*20)

<?php
$refunds = $pagarme->refunds()->getList();

Se preferir, você pode utilizar filtros para trazer apenas o estorno de uma transação em específico, por exemplo:, (*21)

<?php
$transactionRefunds = $pagarme->refunds()->getList([
    'transaction_id' => 'ID_DA_TRANSAÇÃO_ESTORNADA'
]);

Chargebacks

Da mesma forma que estornos, você pode visualizar todos os chargebacks que ocorreram em sua conta., (*22)

<?php
$transactionChargebacks = $pagarme->refunds()->getList();

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., (*23)

Criando cartões

<?php
$card = $pagarme->cards()->create([
    'holder_name' => 'Yoda',
    'number' => '4242424242424242',
    'expiration_date' => '1225',
    'cvv' => '123'
]);

Retornando cartões

<?php
$cards = $pagarme->cards()->getList();

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:, (*24)

<?php
$visaCards = $pagarme->cards()->getList([
    'brand' => 'visa'
]);

Retornando um cartão

<?php
$card = $pagarme->cards()->get([
    'id' => 'ID_DO_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, (*25)

Criando planos

<?php
$plan = $pagarme->plans()->create([
    'amount' => '15000',
    'days' => '30',
    'name' => 'The Pro Plan - Platinum - Best ever'
]);

Retornando planos

<?php
$plans = $pagarme->plans()->getList();

Retornando um plano

<?php
$plan = $pagarme->plans()->get(['id' => '123456']);

Atualizando um plano

<?php
$updatedPlan = $pagarme->plans()->update([
    'id' => '365403',
    'name' => 'The Pro Plan - Susan',
    'trial_days' => '7',
]);

Assinaturas

Criando assinaturas

<?php
$substription = $pagarme->subscriptions()->create([
    'plan_id' => 123456,
    'payment_method' => 'credit_card',
    'card_number' => '4111111111111111',
    'card_holder_name' => 'UNIX TIME',
    'card_expiration_date' => '0722',
    'card_cvv' => '123',
    'postback_url' => 'http://postbacj.url',
    'customer' => [
        'email' => 'time@unix.com',
        'name' => 'Unix Time',
        'document_number' => '75948706036',
        'address' => [
            'street' => 'Rua de Teste',
            'street_number' => '100',
            'complementary' => 'Apto 666',
            'neighborhood' => 'Bairro de Teste',
            'zipcode' => '11111111'
        ],
        'phone' => [
            'ddd' => '01',
            'number' => '923456780'
        ],
        'sex' => 'other',
        'born_at' => '1970-01-01',
    ],
    'metadata' => [
        'foo' => 'bar'
    ]
]);

Criando assinaturas utilizando card_id, (*26)

<?php
// Criando o cartão
$card = $pagarme->cards()->create([
    'holder_name' => 'Yoda',
    'number' => '4242424242424242',
    'expiration_date' => '1225',
    'cvv' => '123'
]);

$substription = $pagarme->subscriptions()->create([
    'plan_id' => 365403,
    'card_id' => $card->id,
    'payment_method' => 'credit_card',
    'postback_url' => 'http://www.pudim.com.br',
    'customer' => [
        'email' => 'time@unix.com',
        'name' => 'Unix Time',
        'document_number' => '75948706036',
        'address' => [
            'street' => 'Rua de Teste',
            'street_number' => '100',
            'complementary' => 'Apto 666',
            'neighborhood' => 'Bairro de Teste',
            'zipcode' => '88370801'
        ],
        'phone' => [
            'ddd' => '01',
            'number' => '923456780'
        ],
        'sex' => 'other',
        'born_at' => '1970-01-01',
    ],
    'metadata' => [
        'foo' => 'bar'
    ]
]);

Split com assinatura

<?php
$substription = $pagarme->subscriptions()->create([
    'plan_id' => 123456,
    'card_id' => 'card_abc123456',
    'payment_method' => 'credit_card',
    'postback_url' => 'http://www.pudim.com.br',
    'customer' => [
        'email' => 'time@unix.com',
        'name' => 'Unix Time',
        'document_number' => '75948706036',
        'address' => [
            'street' => 'Rua de Teste',
            'street_number' => '100',
            'complementary' => 'Apto 666',
            'neighborhood' => 'Bairro de Teste',
            'zipcode' => '88370801'
        ],
        'phone' => [
            'ddd' => '01',
            'number' => '923456780'
        ],
        'sex' => 'other',
        'born_at' => '1970-01-01',
    ],
    'amount' => 10000,
    'split_rules' => [
        [
            'recipient_id' => 're_abc1234abc1234abc1234abc1',
            'percentage' => 20,
            'liable' => true,
            'charge_processing_fee' => true,
        ],
        [
            'recipient_id' => 're_abc1234abc1234abc1234abc1',
            'percentage' => 80,
            'liable' => true,
            'charge_processing_fee' => true,
        ]
    ],
    'metadata' => [
        'foo' => 'bar'
    ]
]);

Retornando uma assinatura

<?php
$substription = $pagarme->subscriptions()->get([
    'id' => 123456
]);

Retornando assinaturas

<?php
$substription = $pagarme->subscriptions()->getList();

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:, (*27)

<?php
$planSubstriptions = $pagarme->subscriptions()->getList([
    'plan_id' => 'ID_DO_PLANO'
]);

Atualizando uma assinatura

<?php
$updatedSubscription = $pagarme->subscriptions()->update([
    'id' => 1234,
    'plan_id' => 4321,
    'payment_method' => 'boleto'
]);

Cancelando uma assinatura

<?php
$canceledSubscription = $pagarme->subscriptions()->cancel([
    'id' => 12345
]);

Transações de assinatura

<?php
$substriptionTransactions = $pagarme->subscriptions()->transactions([
    'subscription_id' => 1245
]);

Pulando cobranças

<?php
$settledCharges = $pagarme->subscriptions()->settleCharges([
    'id' => 12345,
    'charges' => 5
]);

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., (*28)

Para obter informações sobre postbacks, 3 informações serão necessárias, sendo elas: model, model_id e postback_id., (*29)

model: Se refere ao objeto que gerou aquele POSTback. Pode ser preenchido com o valor transaction ou subscription., (*30)

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., (*31)

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_., (*32)

Retornando postbacks

<?php
$postbacks = $pagarme->postbacks()->getList([
    'model' => 'subscription',
    'model_id' => 'ID_DA_ASSINATURA'
]);

Retornando um postback

<?php
$postback = $pagarme->postbacks()->get([
    'model' => 'transaction',
    'model_id' => 'ID_DA_TRANSAÇÃO',
    'postback_id' => 'po_cjlzhftd2006xg573fwelfg9y'
]);

Reenviando um postback

<?php
$postbackRedeliver = $pagarme->postbacks()->redeliver([
    'model' => 'subscription',
    'model_id' => 'ID_DA_ASSINATURA',
    'postback_id' => 'po_cjlzhftd2006xg573fwelfg9y'
]);

Validando uma requisição de postback

<?php
$postbackPayload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_HUB_SIGNATURE'];
$postbackIsValid = $pagarme->postbacks()->validate($postbackPayload, $signature);

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., (*33)

Saldo do recebedor principal

Para saber o saldo de sua conta, você pode utilizar esse código:, (*34)

<?php
$balance = $pagarme->balances()->get();

Operações de saldo

Com este objeto você pode acompanhar todas as movimentações financeiras ocorridas em sua conta Pagar.me., (*35)

Histórico das operações

<?php
$balanceOperations = $pagarme->balanceOperations()->getList();

Se necessário, você pode passar filtros como parâmetro, por exemplo:, (*36)

<?php
$balanceOperations = $pagarme->balanceOperations()->getList([
    'status' => 'available'
]);

Histórico de uma operação específica

<?php
$balanceOperation = $pagarme->balanceOperations()->get([
    'id' => 'BALANCE_OPERATION_ID'
]);

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)., (*37)

Retornando recebíveis

<?php
$payables = $pagarme->payables()->getList();

Se necessário, você pode aplicar filtros na busca dos payables, por exemplo, você pode recuperar todos os payables de uma transação:, (*38)

<?php
$transactionPayables = $pagarme->payables()->getList([
    'transaction_id' => 'ID_DA_TRANSAÇÃO'
]);

Retornando um recebível

<?php
$payable = $pagarme->payables()->get([
    'id' => 'ID_DO_PAYABLE'
]);

Transferências

Transferências representam os saques de sua conta., (*39)

Criando uma transferência

<?php
$transfer = $pagarme->transfers()->create([
    'amount' => 1000,
    'recipient_id' => 're_cjeptpdyg03u3cb6elj68p5ej'
]);

Retornando transferências

<?php
$transfers = $pagarme->transfers()->getList();

Se necessário, você pode aplicar filtros em sua busca, por exemplo:, (*40)

<?php
$recipientTransfers = $pagarme->transfers()->getList([
    'recipient_id' => 'ID_DO_RECEBEDOR'
]);

Retornando uma transferência

<?php
$transfer = $pagarme->transfers()->get([
    'id' => 'ID_DA_TRANSFERÊNCIA'
]);

Cancelando uma transferência

<?php
$canceledTransfer = $pagarme->transfers()->cancel([
    'id' => 'ID_DA_TRANSFERÊNCIA'
]);

Antecipações

Para entender o que são as antecipações, você deve acessar esse link., (*41)

Criando uma antecipação

<?php
$anticipation = $pagarme->bulkAnticipations()->create([
    'recipient_id' => 're_cjeptpdyg03u3cb6elj68p5ej',
    'payment_date' => '1536883200000',
    'requested_amount' => '300000',
    'timeframe' => 'start'
]);

Obtendo os limites de antecipação

<?php
$anticipationLimits = $pagarme->bulkAnticipations()->getLimits([
    'recipient_id' => 'ID_DO_RECEBEDOR',
    'payment_date' => '1536883200000',
    'timeframe' => 'start'
]);

Cancelando uma antecipação pending

<?php
$canceledAnticipation = $pagarme->bulkAnticipations()->cancel([
    'recipient_id' => 'ID_DO_RECEBEDOR',
    'bulk_anticipation_id' => 'ID_DA_ANTECIPAÇÃO',
]);

Retornando antecipações

<?php
$anticipations = $pagarme->bulkAnticipations()->getList([
    'recipient_id' => 'ID_DO_RECEBEDOR'
]);

Se necessário, você pode aplicar filtros nessa busca, por exemplo, pelo valor antecipado:, (*42)

<?php
$anticipations = $pagarme->bulkAnticipations()->getList([
    'recipient_id' => 'ID_DO_RECEBEDOR',
    'amount' => 'VALOR_ANTECIPADO'
]);

Contas bancárias

Contas bancárias identificam para onde será enviado o dinheiro de futuros pagamentos., (*43)

Criando uma conta bancária

<?php
$bankAccount = $pagarme->bankAccounts()->create([
    'bank_code' => '341',
    'agencia' => '0932',
    'agencia_dv' => '5',
    'conta' => '58054',
    'conta_dv' => '1',
    'document_number' => '26268738888',
    'legal_name' => 'API BANK ACCOUNT'
]);

Retornando uma conta bancária

<?php
$bankAccount = $pagarme->bankAccounts()->get([
    'id' => 'ID_DA_CONTA_BANCÁRIA'
]);

Retornando contas bancárias

<?php
$bankAccounts = $pagarme->bankAccounts()->getList();

Se quiser, você pode aplicar filtros para a busca de contas bancárias, como por exemplo, filtrar pelo código do banco:, (*44)

<?php
$bankAccounts = $pagarme->bankAccounts()->getList([
    'bank_code' => '341'
]);

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., (*45)

Criando um recebedor

<?php
$recipient = $pagarme->recipients()->create([
    'anticipatable_volume_percentage' => '85', 
    'automatic_anticipation_enabled' => 'true', 
    'bank_account_id' => '17899179', 
    'transfer_day' => '5', 
    'transfer_enabled' => 'true', 
    'transfer_interval' => 'weekly'
]);

Retornando recebedores

<?php
$recipients = $pagarme->recipients()->getList();

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:, (*46)

<?php
$transferEnabledRecipients = $pagarme->recipients()->getList([
    'transfer_enabled' => true
]);

Retornando um recebedor

<?php
$recipient = $pagarme->recipients()->get([
    'id' => 'ID_DO_RECEBEDOR'
]);

Atualizando um recebedor

<?php
$updatedRecipient = $pagarme->recipients()->update([
    'id' => 'ID_DO_RECEBEDOR',
    'anticipatable_volume_percentage' => 80,
    'transfer_day' => 4
]);

Saldo de um recebedor

<?php
$recipientBalance = $pagarme->recipients()->getBalance([
    'recipient_id' => 'ID_DO_RECEBEDOR',
]);

Operações de saldo de um recebedor

<?php
$recipientBalanceOperations = $pagarme->recipients()->listBalanceOperation([
    'recipient_id' => 'ID_DO_RECEBEDOR'
]);

Operação de saldo específica de um recebedor

<?php
$recipientBalanceOperation = $pagarme->recipients()->getBalanceOperation([
    'recipient_id' => 'ID_DO_RECEBEDOR',
    'balance_operation_id' => 'ID_DA_OPERAÇÃO'
]);

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., (*47)

Criando um cliente

<?php
$customer = $pagarme->customers()->create([
    'external_id' => '#123456789',
    'name' => 'João das Neves',
    'type' => 'individual',
    'country' => 'br',
    'email' => 'joaoneves@norte.com',
    'documents' => [
      [
        'type' => 'cpf',
        'number' => '11111111111'
      ]
    ],
    'phone_numbers' => [
      '+5511999999999',
      '+5511888888888'
    ],
    'birthday' => '1985-01-01'
]);

Retornando clientes

<?php
$customers = $pagarme->customers()->getList();

Retornando um cliente

<?php
$customer = $pagarme->customers()->get([
    'id' => 'ID_DO_CLIENTE'
]);

<?php
$paymentLink = $pagarme->paymentLinks()->create([
    'amount' => 10000,
    'items' => [
        [
            'id' => '1',
            'title' => "Fighter's Sword",
            'unit_price' => 4000,
            'quantity' => 1,
            'tangible' => true,
            'category' => 'weapon',
            'venue' => 'A Link To The Past',
            'date' => '1991-11-21'
        ],
        [
            'id' => '2',
            'title' => 'Kokiri Sword',
            'unit_price' => 6000,
            'quantity' => 1,
            'tangible' => true,
            'category' => 'weapon',
            'venue' => "Majora's Mask",
            'date' => '2000-04-27'
        ],
    ],
    'payment_config' => [
        'boleto' => [
            'enabled' => true,
            'expires_in' => 20
        ],
        'credit_card' => [
            'enabled' => true,
            'free_installments' => 4,
            'interest_rate' => 25,
            'max_installments' => 12
        ],
        'default_payment_method' => 'boleto'
    ],
    'max_orders' => 1,
    'expires_in' => 60
]);

<?php
$paymentLinks = $pagarme->paymentLinks()->getList();

<?php
$paymentLink = $pagarme->paymentLinks()->get([
    'id' => 'ID_DO_LINK_DE_PAGAMENTO'
]);

<?php
$canceledPaymentLink = $pagarme->paymentLinks()->cancel([
    'id' => 'ID_DO_LINK_DE_PAGAMENTO'
]);

Buscas avançadas (Elasticsearch)

Realizando uma busca

<?php
$search = $pagarme->search()->get([                
    "type" => "transaction",
    "query" => [
        "query" => [
            "terms" => [
                "items.id" => [8, 9] // Busca transações com itens de ID 8 e 9
            ]
        ]
    ]
]);

The Versions

26/07 2018

3.x-dev

3.9999999.9999999.9999999-dev http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

06/07 2018

dev-fix/new-api-version

dev-fix/new-api-version http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

02/07 2018

dev-add_circleci

dev-add_circleci http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

05/06 2018

v3.7.8

3.7.8.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

30/05 2018

dev-fix/request-timeout

dev-fix/request-timeout http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

27/05 2018

dev-fix/code-style

dev-fix/code-style http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

22/05 2018

v3.7.7

3.7.7.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

22/05 2018

dev-feature/remove-git-hook

dev-feature/remove-git-hook http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

17/05 2018

dev-fix/api-version

dev-fix/api-version http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

03/05 2018

dev-fix/add-optional-address-data-to-transction

dev-fix/add-optional-address-data-to-transction http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

27/04 2018

v3.7.6

3.7.6.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

27/04 2018

dev-master

9999999-dev http://pagar.me

Pagar.me PHP Library

  Sources   Download

MIT

The Requires

  • ext-curl *
  • ext-json *
  • ext-mbstring *
  • php >5.3

 

The Development Requires

by Pagar.me and contributors

api pagamentos pagar.me pagarme payments brazil pagamento brasil

26/03 2018

dev-fix/bulk-anticipation-tests

dev-fix/bulk-anticipation-tests http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

22/03 2018

dev-feature/add-cvv-to-card-payload

dev-feature/add-cvv-to-card-payload http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

22/03 2018

v3.7.5

3.7.5.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

21/03 2018

v3.7.4

3.7.4.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

21/03 2018

v3.7.3

3.7.3.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

20/03 2018

dev-travis_tunning

dev-travis_tunning http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

09/03 2018

dev-test/acceptance

dev-test/acceptance http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

09/03 2018

v3.7.2

3.7.2.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

09/03 2018

dev-feature/invoice-reminder-to-plan

dev-feature/invoice-reminder-to-plan http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

09/03 2018

dev-feature/capture-with-split-rules

dev-feature/capture-with-split-rules http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

28/02 2018

v3.7.1

3.7.1.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

22/02 2018

dev-feature/add-softdescriptor-to-boleto

dev-feature/add-softdescriptor-to-boleto http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

19/02 2018

v3.7.0

3.7.0.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

16/02 2018

dev-feature/add-customer-id-to-transaction-and-subscription-payload

dev-feature/add-customer-id-to-transaction-and-subscription-payload http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

20/01 2018

dev-feature/abstraction-for-transactions-can-be-paid-on-installments

dev-feature/abstraction-for-transactions-can-be-paid-on-installments http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

04/12 2017

dev-refresh/ca-certificates

dev-refresh/ca-certificates http://pagar.me

Pagar.me PHP Library

  Sources   Download

MIT

The Requires

  • php >5.3
  • ext-curl *
  • ext-json *
  • ext-mbstring *

 

The Development Requires

by Pagar.me and contributors

api pagamentos pagar.me pagarme payments brazil pagamento brasil

29/11 2017

dev-fix/certificate-validation

dev-fix/certificate-validation http://pagar.me

Pagar.me PHP Library

  Sources   Download

MIT

The Requires

  • php >5.3
  • ext-curl *
  • ext-json *
  • ext-mbstring *

 

The Development Requires

by Pagar.me and contributors

api pagamentos pagar.me pagarme payments brazil pagamento brasil

23/11 2017

v3.6.1

3.6.1.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

27/10 2017

dev-remove_key_dump

dev-remove_key_dump http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

26/10 2017

v3.5.0

3.5.0.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

25/10 2017

dev-fix/customerStdClass

dev-fix/customerStdClass http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

25/09 2017

dev-feature/boleto-async

dev-feature/boleto-async http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

06/09 2017

dev-enable-external-id

dev-enable-external-id http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

18/08 2017

v3.4.0

3.4.0.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

05/07 2017

v3.3.2

3.3.2.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

20/06 2017

v3.3.1

3.3.1.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

16/06 2017

dev-fix/update-guzzle

dev-fix/update-guzzle http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

10/06 2017

dev-fixParameterNameSubscriptionUpdate

dev-fixParameterNameSubscriptionUpdate http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

24/05 2017

3.3.0

3.3.0.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

22/05 2017

dev-fix/get-subscription-error-2

dev-fix/get-subscription-error-2 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

15/05 2017

v3.2.4

3.2.4.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

15/05 2017

v3.2.3

3.2.3.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

08/05 2017

3.2.2

3.2.2.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

27/04 2017

3.2.1

3.2.1.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

20/04 2017

v3.2.0

3.2.0.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

19/04 2017

v3.1.9

3.1.9.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

17/04 2017

v3.1.8

3.1.8.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

11/04 2017

v3.1.7

3.1.7.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

11/04 2017

v3.1.6

3.1.6.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

10/04 2017

v3.1.5

3.1.5.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

07/04 2017

v3.1.4

3.1.4.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

31/03 2017

dev-update-readme

dev-update-readme http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

30/03 2017

dev-info/deprecated

dev-info/deprecated http://pagar.me

Pagar.me PHP Library

  Sources   Download

MIT

The Requires

  • php >5.3
  • ext-curl *
  • ext-json *
  • ext-mbstring *

 

The Development Requires

by Pagar.me and contributors

api pagamentos pagar.me pagarme payments brazil pagamento brasil

30/03 2017

dev-info/adding-wiki-information

dev-info/adding-wiki-information http://pagar.me

Pagar.me PHP Library

  Sources   Download

MIT

The Requires

  • php >5.3
  • ext-curl *
  • ext-json *
  • ext-mbstring *

 

The Development Requires

by Pagar.me and contributors

api pagamentos pagar.me pagarme payments brazil pagamento brasil

15/03 2017

v3.1.3

3.1.3.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

13/03 2017

v3.1.2

3.1.2.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

06/03 2017

v3.1.1

3.1.1.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

23/02 2017

v3.1.0

3.1.0.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

21/02 2017

v3.0.3

3.0.3.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

09/02 2017

v3.0.2

3.0.2.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

24/01 2017

v3.0.1

3.0.1.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

16/01 2017

v3.0

3.0.0.0 http://pagar.me

Pagar.Me PHP Library

  Sources   Download

MIT

The Requires

 

The Development Requires

api pagamentos pagar.me pagarme payments brazil pagamento brasil

29/06 2016

v2.0

2.0.0.0 http://pagar.me

Pagar.me PHP Library

  Sources   Download

MIT

The Requires

  • php >5.3
  • ext-curl *
  • ext-json *
  • ext-mbstring *

 

The Development Requires

by Pagar.me and contributors

api pagamentos pagar.me pagarme payments brazil pagamento brasil

24/05 2016

2.x-dev

2.9999999.9999999.9999999-dev

Libery Pagarme PHP

  Sources   Download

The Requires

 

by Lucas Santos

13/11 2015

v1.1.0

1.1.0.0 http://pagar.me

Pagar.me PHP Library

  Sources   Download

MIT

The Requires

  • php >5.3
  • ext-curl *
  • ext-json *
  • ext-mbstring *

 

The Development Requires

by Pagar.me and contributors

api pagamentos pagar.me pagarme payments brazil pagamento brasil

14/05 2015

v1.0.0

1.0.0.0 http://pagar.me

Pagar.me PHP Library

  Sources   Download

MIT

The Requires

  • php >5.3
  • ext-curl *
  • ext-json *
  • ext-mbstring *

 

The Development Requires

by Pagar.me and contributors

api pagamentos pagar.me pagarme payments brazil pagamento brasil