https://github.com/8ctopus/paypal-rest-api
PayPal REST API implementation using PSR-7, PSR-17 and PSR-18
https://github.com/8ctopus/paypal-rest-api
paypal paypal-checkout paypal-rest-api paypal-subscriptions php
Last synced: about 1 month ago
JSON representation
PayPal REST API implementation using PSR-7, PSR-17 and PSR-18
- Host: GitHub
- URL: https://github.com/8ctopus/paypal-rest-api
- Owner: 8ctopus
- License: mit
- Created: 2023-11-17T10:41:43.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-05-22T05:36:02.000Z (over 1 year ago)
- Last Synced: 2024-05-22T13:08:40.858Z (over 1 year ago)
- Topics: paypal, paypal-checkout, paypal-rest-api, paypal-subscriptions, php
- Language: PHP
- Homepage:
- Size: 113 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PayPal REST API
[](https://packagist.org/packages/8ctopus/paypal-rest-api)
[](https://packagist.org/packages/8ctopus/paypal-rest-api)
[](https://packagist.org/packages/8ctopus/paypal-rest-api)
[](https://packagist.org/packages/8ctopus/paypal-rest-api)
[](https://github.com/8ctopus/paypal-rest-api/actions/workflows/tests.yml)
A php implementation of the PayPal REST API using `PSR-7`, `PSR-17` and `PSR-18`.
The package is a work in progress and contributions are welcome. For now, it covers `Orders` (one-time payments), subscriptions (`Products`, `Plans` and `Subscriptions`), `Webhooks` (receive notifications from PayPal when certain events occur) and `Payments`. That's all that's needed to create a store, be it one-time payment or subscription based.
_NOTE_: If you're just starting to use PayPal think twice, as I have found that their apis are unstable, bugs are introduced all the time in production and despite contacting Merchant Technical Support the issues take forever to get fixed. Save yourself the hassle and use a more reliable payment provider.
## install package
composer require 8ctopus/paypal-rest-api
## before you get started
Copy `.env.example` to `.env` and fill in your PayPal REST API credentials. If you don't have credentials yet, follow the guide:
https://developer.paypal.com/api/rest/
## demo
Here's a code sample that shows how to make a one-time payment. To see all possibilites run `php demo.php`. There is also a demo store using this package, check out [PayPal sandbox](https://github.com/8ctopus/paypal-sandbox).
```php
use HttpSoft\Message\RequestFactory;
use HttpSoft\Message\StreamFactory;
use Nimbly\Shuttle\Shuttle;
use Oct8pus\PayPal\Orders;
use Oct8pus\PayPal\Orders\Intent;
use Oct8pus\PayPal\OAuth;
use Oct8pus\PayPal\HttpHandler;
require_once __DIR__ . '/vendor/autoload.php';
$handler = new HttpHandler(
// PSR-18 http client
new Shuttle(),
// PSR-17 request factory
new RequestFactory(),
// PSR-7 stream factory
new StreamFactory()
);
$sandbox = true;
// get authorization token
$auth = new OAuth($sandbox, $handler, 'rest.id', 'rest.secret');
$orders = new Orders($sandbox, $handler, $auth);
// create order
$response = $orders->create(Intent::Capture, 'USD', 10.0);
// you must redirect the user to approve the payment before you can capture
$redirectUrl = "https://www.sandbox.paypal.com/checkoutnow?token={$response['id']}";
...
// once the user has approved the payment, capture it
$response = $orders->capture($args['id']);
if ($response['status'] === 'COMPLETED') {
echo 'payment processed!';
}
```
## run tests
composer test
# references
- PayPal REST API official documentation: https://developer.paypal.com/api/rest/
- PayPal REST archived php SDK https://github.com/paypal/PayPal-PHP-SDK/