payever / core-sdk-php
Core PHP SDK for payever
Installs: 17 879
Dependents: 6
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Requires
- php: >=5.4.0
- ext-curl: *
- ext-json: *
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.18
- monolog/monolog: ^2.9
- phpmd/phpmd: ^2.9
- phpunit/phpunit: ^7.5
- squizlabs/php_codesniffer: ^3.5
Suggests
- ext-mcrypt: If you want to use mcrypt at PseudoRandomStringGenerator
- ext-openssl: If you want to use openssl at PseudoRandomStringGenerator
- ext-pdo: If you want to use MySQLLock
README
This repository contains the open source PHP SDK that allows you to access payever from your PHP app.
This library follows semantic versioning. Read more on semver.org.
Please note: this SDK is used within the payever plugins. It is NOT suitable for custom API integrations. If you would like to integrate with us via API, please visit https://docs.payever.org/shopsystems/api and follow the instructions and code examples provided there.
Troubleshooting
If you faced an issue you can contact us via official support channel - support@getpayever.com
Requirements
- PHP 5.4.0 and later
- PHP cURL extension
Installation
You can use Composer
The preferred method is via composer. Follow the installation instructions if you do not already have composer installed.
Once composer is installed, execute the following command in your project root to install this library:
composer require payever/core-sdk-php
Documentation
Raw HTTP API docs can be found here - https://docs.payever.org/shopsystems/api
Enums
The are several list of fixed string values used inside API. For convenience they are represented as constants and grouped into classes.
- Core
ChannelSet
- list of available payever API channels
API Clients
HTTP API communication with payever happens through API clients. There are several of them for different API categories:
Each one is described in details below.
Configuration
Each API client requires configuration object as the first argument of client's constructor. In order to get the valid configuration object you need to have valid API credentials:
- Client ID
- Client Secret
- Business UUID
Additionally, you need to tell which API channel you're using:
use Payever\Sdk\Core\ClientConfiguration; use Payever\Sdk\Core\Enum\ChannelSet; $clientId = 'your-oauth2-client-id'; $clientSecret = 'your-oauth2-client-secret'; $businessUuid = '88888888-4444-4444-4444-121212121212'; $clientConfiguration = new ClientConfiguration(); $clientConfiguration ->setClientId($clientId) ->setClientSecret($clientSecret) ->setBusinessUuid($businessUuid) ->setChannelSet(ChannelSet::CHANNEL_MAGENTO) ->setApiMode(ClientConfiguration::API_MODE_LIVE) ;
NOTE: All examples below assume you have ClientConfiguration
instantiated inside $clientConfiguration
variable.
Logging
You can setup logging of all API interactions by providing PSR-3 compatible logger instance.
In case if you don't have PSR-3 compatible logger at hand - this SKD contains simple file logger:
use Psr\Log\LogLevel; use Payever\Sdk\Core\Logger\FileLogger; $logger = new FileLogger(__DIR__.'/payever.log', LogLevel::INFO); $clientConfiguration->setLogger($logger);
License
Please see the license file for more information.