paysera / notification-php-client
Notification API PHP client
Installs: 36 806
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 2
Forks: 2
Open Issues: 2
This package is auto-updated.
Last update: 2024-12-05 16:31:26 UTC
README
#NotificationPhpClient
##What is NotificationPhpClient?
This is a library for webtopay.com Notification API. It allows you to easily check sign and parse the callback request from webtopay.com about funds in your account. You have to set-up notifications in "Account settings" page on webtopay.com to get the notifications.
##Installation
###Manual
- Use
git clone https://github.com/evp/NotificationPhpClient.git
to copy the NotificationPhpClient directory to your project directory. - Add the following code to your PHP file where you intend to check notification callbacks:
require_once '/path/to/NotificationPhpClient/src/Evp/Notification/Autoloader.php'; Evp_Notification_Autoloader::register();
This will ensure that all of the library's classes are properly loaded. Make sure you change the 'path/to' to the actual path of the NotificationPhpClient.
###Composer
- Add
"paysera/notification-php-client": "dev-master"
dependency to composer.json file. - Execute
composer update paysera/notification-php-client
in your project directory.
##Using the library
$notification = Evp_Notification_Container::create()->getRequestParser()->parseRequest($_POST);
Evp_Notification_Container::create
method is used for fluent interface, you can create container by using new
keyword.
Evp_Notification_RequestParser::parseRequest
method returns instance of Evp_Notification_Entity_OperationNotification
,
which provides interface for getting the data from callback.
You can use method Evp_Notification_RequestParser::parseRequestToArray
to get all passed parameters as an array
if you prefer.
You can customize the parameters and services by providing optional array parameter when creating Evp_Notification_Container
.
Each time when callback is parsed and signature is checked, public key is requested from webtopay.com server. To cache
public key, provide parameter cache.filePath
to container. For example:
$container = new Evp_Notification_Container(array( 'cache.filePath' => '/tmp/evp.notifications.public-key.php', ));
Be aware that this file must be in a safe place that no other script or third party could overwrite it. Otherwise security can be breached by replacing the public key. If there is no cache available, file is not readable or sign is invalid with cached key, public key will be downloaded from webtopay.com and saved to cache.
Notification API requires that response code would be 200 and content would start with "OK". Library does not provide any method to give this kind of response.
If signature check does not pass or some other issue occurs, library throws an exception. You can process those exceptions by catching them:
try { $notification = Evp_Notification_Container::create()->getRequestParser()->parseRequest($_POST); // process $notification somehow echo 'OK'; } catch (Evp_Notification_Exception $exception) { // log $exception somehow // do not respond 'OK' if you want that callback would be repeated after some time echo 'Error: ' . $exception; }
##Running tests
Run phpunit
in the base directory.