mprince/pagarme-laravel

Pagar.me SDK for Laravel applications.

v0.3.0 2017-09-19 03:25 UTC

This package is auto-updated.

Last update: 2024-12-11 10:53:34 UTC


README

Latest Version on Packagist Software License Build Status StyleCI Coverage Status Quality Score Total Downloads

Pagar.me SDK for Laravel applications.

Install

Via Composer

$ composer require flyingluscas/pagarme-laravel

Usage

Set up

Set up the service provider and the facade in your config/app.php file.

You can skip this step on Laravel 5.5 due to the self-discovery package feature.

'providers' => [
    FlyingLuscas\PagarMeLaravel\PagarMeServiceProvider::class,
],

'aliases' => [
    'PagarMe' => FlyingLuscas\PagarMeLaravel\PagarMeFacade::class,
],

Configurations

Publish the config/pagarme.php file and set your authentication keys, you can get them here.

$ php artisan vendor:publish --provider="FlyingLuscas\PagarMeLaravel\PagarMeServiceProvider"

Checkout Directive

Use the blade directive @checkout to easily set up the checkout form.

<form action="/payment" method="post">
    @checkout([
        'button-text' => 'Pay',
        'amount' => '1000',
        'customer-data' => 'true',
        'payment-methods' => 'boleto,credit_card',
        'ui-color' => '#bababa',
        'postback-url' => 'requestb.in/1234',
        'create-token' => 'true',
        'interest-rate' => '12',
        'free-installments' => '3',
        'default-installment' => '5',
        'header-text' => 'Title',
    ])
</form>

More examples on how to use the checkout form please visit the official documentation.

Facade

You can easily interact with the SDK using the facade class, see a quick example.

PagarMe::transaction()
    ->boletoTransaction(
        1000,
        $customer,
        'http://requestb.in/pkt7pgpk',
        ['id_product' => 13933139]
    );

More examples on how to use the SDK please visit the official documentation available here.

Change log

Please see CHANGELOG for more information on what has changed recently.

Testing

$ composer test

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email lucas.pires.mattos@gmail.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.