bgaetealvear / paypal-laravel-58
Laravel plugin For Processing Payments Through Paypal Express Checkout. Can Be Used Independently With Other Applications.
Requires
- guzzlehttp/guzzle: ~6.0|~7.0
- illuminate/support: ~5.1|~5.2|~5.3|~5.4|~5.5|~5.6|~5.7|~5.8
- nesbot/carbon: ~1.0|~2.0
Requires (Dev)
- phpunit/phpunit: ^5.7|^6.0|^7.0
- symfony/var-dumper: ~3.0|~4.0|~5.0
This package is auto-updated.
Last update: 2024-04-29 04:53:37 UTC
README
Introduction
By using this plugin you can process or refund payments and handle IPN (Instant Payment Notification) from PayPal in your Laravel application.
This plugin supports the new paypal rest api.
PayPal API Credentials
This package uses the new paypal rest api. Refer to this link on how to create API credentials:
https://developer.paypal.com/docs/api/overview/
Installation
- Use following command to install:
composer require bgaetealvear/paypal-laravel-58
Perform the following steps if you are using Laravel 5.4 or less.
- Add the service provider to your
providers[]
array inconfig/app.php
file like:
BGaeteAlvear\PayPal\Providers\PayPalServiceProvider::class
- Add the alias to your
aliases[]
array inconfig/app.php
file like:
'PayPal' => BGaeteAlvear\PayPal\Facades\PayPal::class
- Run the following command to publish configuration:
php artisan vendor:publish --provider "BGaeteAlvear\PayPal\Providers\PayPalServiceProvider"
Configuration
- After installation, you will need to add your paypal settings. Following is the code you will find in config/paypal.php, which you should update accordingly.
return [ 'mode' => env('PAYPAL_MODE', 'sandbox'), // Can only be 'sandbox' Or 'live'. If empty or invalid, 'live' will be used. 'sandbox' => [ 'client_id' => env('PAYPAL_SANDBOX_CLIENT_ID', ''), 'client_secret' => env('PAYPAL_SANDBOX_CLIENT_SECRET', ''), 'app_id' => 'APP-80W284485P519543T', ], 'live' => [ 'client_id' => env('PAYPAL_LIVE_CLIENT_ID', ''), 'client_secret' => env('PAYPAL_LIVE_CLIENT_SECRET', ''), 'app_id' => '', ], 'payment_action' => env('PAYPAL_PAYMENT_ACTION', 'Sale'), // Can only be 'Sale', 'Authorization' or 'Order' 'currency' => env('PAYPAL_CURRENCY', 'USD'), 'notify_url' => env('PAYPAL_NOTIFY_URL', ''), // Change this accordingly for your application. 'locale' => env('PAYPAL_LOCALE', 'en_US'), // force gateway language i.e. it_IT, es_ES, en_US ... (for express checkout only) 'validate_ssl' => env('PAYPAL_VALIDATE_SSL', true), // Validate SSL when creating api client. ];
- Add this to
.env.example
and.env
#PayPal Setting & API Credentials - sandbox
PAYPAL_SANDBOX_CLIENT_ID=
PAYPAL_SANDBOX_CLIENT_SECRET=
#PayPal Setting & API Credentials - live
PAYPAL_LIVE_CLIENT_ID=
PAYPAL_LIVE_CLIENT_SECRET=
Usage
Following are some ways through which you can access the paypal provider:
// Import the class namespaces first, before using it directly use BGaeteAlvear\PayPal\Services\PayPal as PayPalClient; $provider = new PayPalClient; // Through facade. No need to import namespaces $provider = PayPal::setProvider();
Override PayPal API Configuration
You can override PayPal API configuration by calling setApiCredentials
method:
$provider->setApiCredentials($config);
Get Access Token
After setting the PayPal API configuration by calling setApiCredentials
method. You need to get access token before performing any API calls
$provider->getAccessToken();
Set Currency
By default the currency used is USD
. If you wish to change it, you may call setCurrency
method to set a different currency before calling any respective API methods:
$provider->setCurrency('EUR');
Support
This plugin only supports Laravel 5.1 to 5.8.
- In case of any issues, kindly create one on the Issues section.
- If you would like to contribute:
- Fork this repository.
- Implement your features.
- Generate pull request.