mattiabasone / pagonline
PagOnline API Library with Laravel integration
Installs: 13 939
Dependents: 0
Suggesters: 0
Security: 0
Stars: 6
Watchers: 4
Forks: 2
Open Issues: 1
Requires
- php: >=8.0.2
- ext-curl: *
- ext-libxml: *
- ext-mbstring: *
- ext-simplexml: *
- guzzlehttp/guzzle: ~6.0|^7.0
- illuminate/support: ^9.0|^10.0|^11.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.0
- illuminate/config: ^9.0|^10.0|^11.0
- orchestra/testbench: ^7.0|^8.0|^9.0
- php-coveralls/php-coveralls: ^2.7
- phpstan/phpstan: ^1.11
- phpunit/phpunit: ^9.0|^10.0|^11.0
This package is auto-updated.
Last update: 2024-11-04 21:46:07 UTC
README
This library can be used with PagOnline Payment Gateway and it can be easily integrated in Laravel.
With this package I'm trying to improve the crappy IGFS CG PHP Library provided by PagOnline Payment gateway.
Basic Usage
Demo scripts can be found in tests/demo
, example Init Request:
<?php require __DIR__.'/vendor/autoload.php'; $init = new \PagOnline\Init\IgfsCgInit(); $init->serverURL = "https://payment-gateway-example.com/IGFS_CG_SERVICES/services"; $init->tid = "MY-TID-CODE"; $init->kSig = '1234567890987654321'; $init->shopID = 'my-transaction-id'; $init->shopUserRef = "email@example.org"; $init->trType = "AUTH"; $init->currencyCode = "EUR"; $init->amount = 500; // Amount without comma (500 = 5,00) $init->langID = "IT"; $init->notifyURL = "http://my-domain.tld/verify.php"; $init->errorURL = "http://my-domain.tld/error.php"; $init->addInfo1 = 'myFirstAddintionalInfo'; // if you need to edit http client parameters... $init->setRequestTimeout(10); // Seconds $init->setConnectTimeout(5); // Seconds $init->setHttpProxy('tcp://some.proxy'); // Proxy server for requests $init->setHttpAuthUser('username'); // HTTP Basic Auth username $init->setHttpAuthPass('password'); // HTTP Basic Auth password if (!$init->execute()) { // Something went wrong } else { // Redirect user to payment gateway header("location: ".$init->redirectURL); }
Usage in Laravel
Using Laravel 5.5+, the PagOnline service provider is automagically loaded at startup. It loads the config file and the Factory Facade that can be used to create IgfsCg class instances.
Using Laravel auto-discovery feature you don't need to do that, anyway you can use artisan command vendor:publish
to copy pagonline.php
config file for older Laravel versions:
php artisan vendor:publish --provider="PagOnline\Laravel\PagOnlineServiceProvider"
You also need to register the PagOnline Service Provider (PagOnline\Laravel\PagOnlineServiceProvider
).
Facade usage
use IgfsCg; use PagOnline\Actions; [...] class MyController { public function mySuperMethod() { $igfsCgInit = IgfsCg::make(Actions::IGFS_CG_INIT); // Do something } }
.env file configuration
Set the following environment variables in your .env
file:
PAGONLINE_SERVER_URL
payment gateway server url (default: null)PAGONLINE_REQUEST_TIMEOUT
maximum timeout in seconds for completing a request (default: 15)PAGONLINE_CONNECT_TIMEOUT
maximum timeout in seconds for connecting to the server (default: 5)PAGONLINE_TERMINAL_ID
identifier provided by the payment gateway (default: null)PAGONLINE_SIGNATURE_KEY
signature key provided by the payment gateway (default: null)PAGONLINE_CURRENCY_CODE
currency code (default: EUR)PAGONLINE_LANGUAGE_ID
language code (default: IT)
TODO
- Unit Tests
Contributing
If you want to contribute to this project, please use php-cs-fixer to format your code to PSR standards and rules
specified in the configuration file .php_cs.dist
provided in this repository.
Thank you!