lzaplata/certitrade

Certitrade wrapper for Nette Framework.

Certitrade

This is small Nette Framework wrapper for Certitrade gateway., _(*1)

Installation

The easiest way to install library is via Composer., _(*2)

$ composer require lzaplata/certitrade: dev-master

or edit composer.json in your project, _(*3)

"require": {
        "lzaplata/certitrade": "dev-master"
}

You have to register the library as extension in config.neon file., _(*4)

extensions:
        payu: LZaplata\Certitrade\DI\Extension

Now you can set parameters..., _(*5)

certitrade:
        merchantId      : *
        apiKey          : *
        sandbox         : true
        language        : en        // must be 2 digits language code
        currency        : SEK       // must be 3 digits uppercase currency code

...and autowire library to presenter, _(*6)

use LZaplata\Certitrade\Service;

/** @var Service @inject */
public $certitrade;

Usage

Before payment

In first step you must create new payment., _(*7)

$payment = $this->certitrade->createOrder([
        "description" => $description,           
        "amount" => $price,                         // order price in lowest currency unit (1 CZK = 100)
        "reference" => $id,                         // eshop unique id
        "return_url" => $returnUrl,                 // return url from gateway (no matter of payment result)
        "callback_url" => $callbackUrl,             // url to report back via POST call while payment is under way
]);

Second step decides if creating order is successful..., _(*8)

try {
        $response = $this->certitrade->pay($payment);
} catch (\Exception $e) {
        print $e->getMessage();
}

...before redirecting to gateway you can get Certitrade ID and merge it with your order, _(*9)

$certitradeId = $response->id;

// updates order
$this->updateOrder($certitradeId);

...and finally you can redirect to gateway., _(*10)

$this->sendResponse($response);

After payment

You can get payment via Certitrade ID..., _(*11)

$payment = $this->certitrade->getPayment($certitradeId);

...end decide if payment has been payed., _(*12)

if ($this->certitrade->isPaid($payment)) {
    // do something
} else {
    // otherwise do something else
}