- PHP >= 7.4
Using Composer
composer require sovic/pays-cz-php-sdk
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