Download the PHP package beebmx/laravel-pay without Composer

Payments for Laravel

Payments for Laravel is inspired by the official Laravel Cashier. The approach is slightly different to Cashier and the main behavior is the payment transactions.

Installation

You can install the package via composer:

You can publish and run the migrations with:

You can publish the config file with:

Configuration

Before use Payments for Laravel you need to add the Payable trait to your user model, the default location of this is in App\Models\Users:

Custom models

You can use your own models to fit your needs, just set in the App\Providers\AppServiceProvider and inform Payments for Laravel in the boot method:

Just remember, if you change this for your own models, make sure to extend these models with the Payments for Laravel:

Drivers

Sandbox

This works as a playground, with full capabilities as a testing or production driver.

Stripe

To work with the stripe driver you need to set as default driver and configurate your testing or production keys:

Conekta

To work with the conekta driver you need to set as default driver and configurate your testing or production keys:

Customer

Create customer

A user can be a customer (this is not a requirement) and will create a customer in the correspond driver. To create a customer just use the method createCustomerWithDriver:

Basic information

When a user becomes to customer, the columns used to create it, comes from the model, but you can customize this with:

Creating a user can be useful for recurring payments or to avoid asking for payment methods all the time.

Payment Methods

To add a payment method, first you need to have a customer on the driver platform. After you have your customer just add the right token or payment_method:

``

Shipping

If your payment have a shipping, just add the proper address before perform the payment:

Remember that this package have an address model build in out of the box.

Payments

To perform a payment is as easy as:

If you have more than one product or service:

If you have a discount to be applied you can set it:

Or you can set it with more information like:

It's important that the user has at least one payment method.

If you have a shipping address:

If you don't need to create a payment method you can create a charge with a one time payment token:

If you are using the token option, the createCustomerWithDriver is optional and not required.

If you need the payment transaction, you can retrive it with the getTransaction() method:

Webhooks

By default Payments for Laravel provides a handy management of webhooks.

First in your App\Http\Middleware\VerifyCsrfToken file, you need to allow the path of the WebhookController:

The default path is pay/webhooks but you can change it in the config file, updating the pay.path and pay.webhooks.

You can create manually your endpoint in your driver provider site or with the command:

The driver sandbox doesn't allow the creation of webhooks.

Handlers

The WebhookController always react to the events emitted from the driver provider and passes to the correct handler. By default, every driver has their own handler defined in the config/pay.php file:

You can change the handler with your own implementation, just make your to extends from the right handler.

The methods names should correspond to the convention, first all methods should be prefixed with handle and the "camel case" name of the webhook you wish to handle. For example, if you wish to handle the payment_intent.succeeded webhook, you should add a handlePaymentIntentSucceeded method to the controller:

On each handled method an array with $payload correspondence is always received.

Webhook events

On each webhook call, the following events could be dispatched:

• Beebmx\LaravelPay\Events\WebhookReceived
• Beebmx\LaravelPay\Events\WebhookHandled

You can create your own implementation of the payload:

To listen this implementation is required to register in your App\Providers\EventServiceProvider:

Testing

Changelog

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

Credits

• Fernando Gutierrez
• All Contributors

License

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