CGWebPaySimple

PHP script pre jednoduchšiu integráciu platobnej brány GP WebPay.

Nastavenie premenných

Statické premenné

$merchantNumber = "xxxxxxxxxx";                  // ID obchodníka
$privateKey = "private_key_file_name";           // názov súboru súkromného klúču (klúč treba vložiť do zložky /cgwebpaysimple/key/)
$privateKeyPassword = "K3yP455w0Rd";             // heslo k súkromnému klúču
$publicKey = "public_key_file_name";             // názov súboru verejného klúču (klúč treba vložiť do zložky /cgwebpaysimple/key/)
$publicKeyGP = "gp_public_key_file_name";        // názov súboru verejného klúču portálu GP WebPay (klúč treba vložiť do zložky /cgwebpaysimple/key/)
$returnURL = "https://exampleshop.com";          // URL adresa na ktorú bude zákazník presmerovaný po odoslaní platby
$buttonText = "Zaplatiť";                        // text tlačidla - môže obsahovať aj HTML tagy (napr. fontawesome ikonky atď.)
$production = false;                             // prepnutie testovacieho a produkčného módu (false = testovanie, true = produkcia)
$depositflag = 0;                                // 0 = po schválení platby ju treba manuálne potvrdiť v systéme GPWebPay, 1 = platba sa úp schválení automaticky potvrdí

Dynamické premenné

$paymentNumber = "123456";                       // ID platby - pre jednu objednávku môže byť viac platieb, pre prípad že nejaká neprejde, preto je potrebné zadať ID platby
$orderNumber = "123456";                         // ID objednávky
$price = "15039";                                // suma (musí byť v tvare bez desatinných čísel, suma 15039 reprezentuje 150,39€)
$clientEmail = "[email protected]";              // email zákazníka na ktorý príde potvrdenie o platbe

Použitie scriptu

Vytvorenie inštancie scriptu

require_once 'cgwebpaysimple/CGWebPaySimple.php';
$cgWebPaySimple = new CGWebPaySimple($production);        // parameter $production je nepovinný (default je false)

Inicialitácia s použitím statických premenných

$cgWebPaySimple->init($merchantNumber, $privateKey, $privateKeyPassword, $publicKey, $publicKeyGP);

Zaplatenie objednávky

Použité parametre sú popísané v sekcii Nastavenie premenných vyššie

Vytvorenie tlačidla pre zaplatenie

$cgWebPaySimple->getForm($paymentNumber, $orderNumber, $price, $clientEmail, $depositflag, $returnURL, $buttonText);

Priame presmerovanie na platbu bez tlačidla

$cgWebPaySimple->openPayment($paymentNumber, $orderNumber, $price, $clientEmail, $depositflag, $returnURL);

Získanie významov kódov

Vypísanie významov kódov ktoré vráti platobná brána po presmerovaní späť na eshop. Hodnoty ktoré sa vypisujú je možné upraviť v súbore /cgwebpaysimple/return_codes.php. Pre vypísanie týchto hodnôt nie je potrebné mať inicializáciu scriptu, stačí vytvorená inštancia.

echo $cgWebPaySimple->getPRCode();        // primárny kód
echo $cgWebPaySimple->getSRCode();        // sekundárny kód