We only support current PHP version, so this library needs at least PHP 8.1.
To keep it simple, we uses Composer. You only need to run the following commmand :
composer require stancer/stancerThe library uses cURL internaly to connect to the API.
You need the php extension phpX.Y-curl, where X.Y correspond to your PHP version, to be installed on your server.
You may also use Guzzle or every PSR7 compatible client to replace the internal cURL instance. You only need to provider the client instance to the API config.
<?php
$config = Stancer\Config::init($key);
$config->setHttpClient($guzzle);All you need is a valid API key.
<?php
$key = 'my_api_key_kSp7hBH3hyDQ36izsyKR';
Stancer\Config::init($key);
$card = new Stancer\Card();
$card->setNumber('4111111111111111');
$card->setExpMonth(12);
$card->setExpYear(2022);
$card->setCvc('999');
$card->setName('John Doe');
$payment = new Stancer\Payment();
$payment->setCard($card);
$payment->setAmount(1000); // You must put an integer, here we wanted USD$10.00
$payment->setCurrency('USD');
$payment->description('My first payment');
$payment->send();To retrieve an object, just put an identifier when creating a new instance.
<?php
$payment = new Stancer\Payment('paym_KIVaaHi7G8QAYMQpQOYBrUQE');To create an object, like a payment, use the send method.
<?php
$payment = new Stancer\Payment();
$payment->setCard($card); // Pay with a card
// or
$payment->setSepa($sepa); // Pay with a bank account (SEPA, uses BIC and IBAN)
// Do not forget to complete your payment informations
$payment->send();The easiest way to do it, use Payment::refund() method.
There is a simple example :
<?php
$payment = new Stancer\Payment('paym_KIVaaHi7G8QAYMQpQOYBrUQE');
$payment->refund(); // To refund the full payment
// or
$payment->refund($amount); // To refund a particular amount
$payment->getRefunds(); // Will return all refunds made on a paymentEvery exceptions thrown by this project extend from Stancer\Exceptions\Exception.
Some exceptions are related to the connection with the API :
Stancer\Exceptions\TooManyRedirectsExceptionon 310 HTTP errorsStancer\Exceptions\BadRequestExceptionon 400 HTTP errorsStancer\Exceptions\NotAuthorizedExceptionon 401 HTTP errors (basically bad credential)Stancer\Exceptions\NotFoundExceptionon 404 HTTP errorsStancer\Exceptions\ConflictExceptionon 409 HTTP errors
Or with less specificity :
Stancer\Exceptions\RedirectionExceptionon 3** HTTP errors (technically only Too many redirection)Stancer\Exceptions\ClientExceptionon 4** HTTP errorsStancer\Exceptions\ServerExceptionon 5** HTTP errors
You can see other exceptions, not related to HTTP traffic :
Stancer\Exceptions\BadMethodCallExceptionwhen you are calling an unknown methodStancer\Exceptions\InvalidArgumentExceptionwhen you are using a method without the right arguments
For these two exceptions, you need to check you code, they should never appear in real world.
To see every available exceptions, simply take a look in src/Exceptions folder.
You can add a PSR3 compatible logger.
We suggeset monolog but anything implementing log interfaces can be use.
<?php
$log = new Monolog\Logger('Stancer');
$log->pushHandler(new Monolog\Handler\StreamHandler('path/to/your.log', Monolog\Logger::INFO));
$config->setLogger($logger);-
Never, never, NEVER register a card or a bank account number in your database.
-
Always uses HTTPS in card/SEPA in communication.
-
Our API will never give you a complete card/SEPA number, only the last four digits. If you need to keep track, use these last four digit.
We can contribute and modify everything, you just need to follow some rules :
- Fork the project
- Make a topic branch (aka one branch for one feature or one bug)
- Test locally
- Complete the
Unreleasedpart of the changelog - Make a merge/pull request
Every MR/PR MUST have unit test and CHANGELOG entries to be approved.
Our unit testing framework is atoum. It is fast and easy to learn. Go see the documentation.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent