sovic/pays-cz-php-sdk

PHP SDK for Pays.cz payment gateway

v1.0.0 2022-02-16 20:12 UTC

Requires

• php: >=7.4
• ext-json: *
• guzzlehttp/guzzle: ^7.3

Requires (Dev)

• roave/security-advisories: dev-master

MIT

• php
• payments
• sdk
• gateway
• pays.cz

README

Requirements

• PHP >= 7.4

Installation

Using Composer

composer require sovic/pays-cz-php-sdk

Usage

Init

$pays = new Pays('{merchant-id}', '{shop-id}', '{secret}');

Create payment

$paysPayment = $pays->createPayment('{shop-payment-id}', '{price}', '{currency}'); 
$paysPayment->setEmail('{customer-email}'); // optionally add customer email for Pays.cz notifications

// get Pays.cz gateway url (E.g. for payment button)
$url = $pays->buildPaymentUrl($paysPayment, '{return-url}');

// redirect to Pays.cz gateway directly
$pays->redirectToPaymentUrl($paysPayment, '{return-url}');

Validate Pays.cz status request

$query = [ … ]; // query params array from HTTP request

try {
    $paysPayment = $pays->validatePaymentRequestQuery($query);
    if ($paysPayment->isPaid()) {
        // handle successful payment
        $clientPaymentId = $paysPayment->getClientPaymentId();
    } else {
        // handle failed|cancelled payment
    }
} catch(Exception $e) {
    // invalid request, some parameter missing or invalid signature hash, output 400 Bad Request
}

// all OK, output 202 Accepted