paysys/tatrapay

Library for Tatra bank TatraPay gateway in Nette framework.

PaySys\TatraPay

, _(*1)

Library for implement TatraPay gateway (v4.0 with HMAC & ECDSA) from Tatra Banka in Nette framework., _(*2)

Requirements

Requires PHP 7.1 or later., _(*3)

Use universal libraty PaySys\PaySys., _(*4)

Installation

The best way to install Unique is use Composer package PaySys/TatraPay., _(*5)

$ composer require paysys/tatrapay

Configuration

extensions:
    TatraPay: PaySys\TatraPay\DI\TatraPayExtension

TatraPay:
    mid: '1234'
    key: '64-bit hexadecimal string'

Events

Object PaySys\PaySys\Button

Service PaySys\TatraPay\Security\Response

Example

Generating payment button

Set PaySys\TatraPay\Payment., _(*6)

Button need PaySys\PaySys\IConfiguration service. Use DI generated factory PaySys\TatraPay\IButtonFactory for getting configured PaySys\PaySys\Button component., _(*7)

Now set $onPayRequest event on PaySys\PaySys\Button for redirect to TatraPay gateway. Signed redirect URL is genereated by service PaySys\TatraPay\Security\Request->getUrl(PaySys\TatraPay\Payment $payment)., _(*8)

class OrderPresenter extends Presenter
{
    /** @var \PaySys\TatraPay\IButtonFactory @inject */
    public $tatraPayButtonFactory;

    /** @var \PaySys\TatraPay\Security\Request @inject */
    public $tatraPayRequest;

    protected function createComponentTatraPayButton()
    {
        $payment = new \PaySys\TatraPay\Payment("12.34", "00456", "John Doe");
        $button = $this->tatraPayButtonFactory->create($payment);
        $button->onPayRequest[] = function ($payment) {
            $this->redirectUrl($this->TatraPayRequest->getUrl($payment));
        };
        return $button;
    }
}

Process payment response

Event-driven processing

Default is Bank response routed to included presenter TatraPay:TatraPay:process. In this case are automatic called events on service PaySys\TatraPay\Security\Response., _(*9)

For processing payment by events use for example Kdyby\Events., _(*10)

Own presenter

Too it's possible write own Nette\Application\UI\Presenter for hnadling payment. In this case are events called same as before example., _(*11)

class OrderPresenter extends Presenter
{
    /** @var Nette\Http\IRequest @inject */
    public $httpRequest;

    /** @var \PaySys\TatraPay\Security\Response @inject */
    public $bankResponse;

    public function actionProcessTatraPay()
    {
        try {
            $this->bankResponse->paid($this->httpRequest->getQuery());
            // store info about payment
            $this->flashMessage('Thanks for payment.', 'success');
        } catch (\PaySys\PaySys\Exception $e) {
            // log
            $this->flashMessage('Payment failed. Please try it later.', 'danger');
        }
        $this->redirect('finish');
    }
}

Now just add route to configuration:, _(*12)

tatraPay:
    rurl: Order:processTatraPay

Exceptions

class \PaySys\PaySys\Exception extends \Exception {}
class \PaySys\PaySys\SignatureException extends \PaySys\PaySys\Exception {}
class \PaySys\PaySys\ServerException extends \PaySys\PaySys\Exception {}
class \PaySys\PaySys\InvalidArgumentException extends \PaySys\PaySys\Exception {}
class \PaySys\PaySys\ConfigurationException extends \PaySys\PaySys\Exception {}