paylike / php-api
PHP SDK to communicate with the Paylike HTTP API
Installs: 245 882
Dependents: 2
Suggesters: 0
Security: 0
Stars: 10
Watchers: 5
Forks: 12
Open Issues: 1
Requires
- php: >=5.6.0
- ext-curl: *
Requires (Dev)
- phpunit/phpunit: ^9.6.3
README
Paylike client (PHP)
You can sign up for a Paylike account at https://paylike.io.
Getting an API key
An API key can be obtained by creating a merchant and adding an app through Paylike dashboard.
Requirements
PHP 5.3.3 and later.
Install
You can install the package via Composer. Run the following command:
composer require paylike/php-api
If you don't use Composer, you can download the latest release and include the init.php
file.
require_once('/path/to/php-api/init.php');
Dependencies
The bindings require the following extension in order to work properly:
If you use Composer, these dependencies should be handled automatically. If you install manually, you'll want to make sure that these extensions are available.
If you don't want to use curl, you can create your own client to extend from HttpClientInterface
and send that as a parameter when instantiating the Paylike
class.
Example
$paylike = new \Paylike\Paylike($private_api_key); // fetch a card $cards = $paylike->cards(); $card = $cards->fetch($card_id); // capture a transaction $transactions = $paylike->transactions(); $transaction = $transactions->capture($transaction_id, array( 'amount' => 100, 'currency' => 'EUR' ));
Methods
$paylike = new \Paylike\Paylike($private_api_key); $apps = $paylike->apps(); $apps->create($args); $apps->fetch(); $merchants = $paylike->merchants(); $merchants->create($args); $merchants->fetch($merchant_id); $merchants->update($merchant_id, $args); $all_merchants = $merchants->find($app_id,$args); $some_merchants = $merchants->before($app_id,$before); $some_merchants = $merchants->after($app_id,$before); $all_lines = $merchants->lines()->find($merchant_id,$args); $some_lines = $merchants->lines()->before($merchant_id,$before); $some_lines = $merchants->lines()->after($merchant_id, $after); $all_apps = $merchants->apps()->find($merchant_id,$args); $merchants->lines()->add($merchant_id,$app_id); $merchants->lines()->revoke($merchant_id,$app_id); $cards = $paylike->cards(); $cards->create($merchant_id, $args); $cards->fetch($card_id); $transactions = $paylike->transactions(); $transactions->create($merchant_id, $args); $transactions->fetch($transaction_id); $transactions->capture($transaction_id, $args); $transactions->void($transaction_id, $args); $transactions->refund($transaction_id, $args); $all_transactions = $transactions->find($merchant_id,$args); $some_transactions = $transactions->before($merchant_id,$before); $some_transactions = $transactions->after($merchant_id,$before); // explicit args $limit = 10; $after = '5b8e839d7cc76f04ecd3f733'; $before = '5b98deef882cf804f6108700'; $api_transactions = $transactions->find($merchant_id, array( 'limit' => $limit, 'after' => $after, 'before' => $before, 'filter' => array( 'successful' => true ) ));
Pagination
The methods that return multiple merchants/transactions (find,after,before) use cursors, so you don't need to worry about pagination, you can access any index, or iterate all the items, this is handled in the background.
Error handling
The api wrapper will throw errors when things do not fly. All errors inherit from
ApiException
. A very verbose example of catching all types of errors:
$paylike = new \Paylike\Paylike($private_api_key); try { $transactions = $paylike->transactions(); $transactions->capture($transaction_id, array( 'amount' => 100, 'currency' => 'EUR' )); } catch (\Paylike\Exception\NotFound $e) { // The transaction was not found } catch (\Paylike\Exception\InvalidRequest $e) { // Bad (invalid) request - see $e->getJsonBody() for the error } catch (\Paylike\Exception\Forbidden $e) { // You are correctly authenticated but do not have access. } catch (\Paylike\Exception\Unauthorized $e) { // You need to provide credentials (an app's API key) } catch (\Paylike\Exception\Conflict $e) { // Everything you submitted was fine at the time of validation, but something changed in the meantime and came into conflict with this (e.g. double-capture). } catch (\Paylike\Exception\ApiConnection $e) { // Network error on connecting via cURL } catch (\Paylike\Exception\ApiException $e) { // Unknown api error }
In most cases catching NotFound
and InvalidRequest
as client errors
and logging ApiException
would suffice.
Development
Install dependencies:
composer install
Tests
Install dependencies as mentioned above (which will resolve PHPUnit), then you can run the test suite:
./vendor/bin/phpunit