endelwar/gestpayws

PHP implementation of GestPay (Banca Sella) Web Services

GestPayWS

, _(*1)

PHP implementation of GestPay (Banca Sella) Web Services, _(*2)

Highlights

• Simple API
• Decoupled classes
• PHPUnit tested
• Framework agnostic
• Composer ready, PSR-2 and PSR-4 compliant

System Requirements

You need PHP >= 5.6 and the soap extension to use the library, but the latest stable version of PHP is recommended., _(*3)

Install

Install EndelWar/GestPayWS using Composer., _(*4)

$ composer require endelwar/gestpayws

Using

Crypt

``` php require DIR . '/../vendor/autoload.php';, <sub>(*5)</sub>

use EndelWar\GestPayWS\WSCryptDecryptSoapClient; use EndelWar\GestPayWS\WSCryptDecrypt; use EndelWar\GestPayWS\Parameter\EncryptParameter; use EndelWar\GestPayWS\Data;, <sub>(*6)</sub>

// enable or disable test environment $enableTestEnv = true; $soapClient = new WSCryptDecryptSoapClient($enableTestEnv); try { $gestpay = new WSCryptDecrypt($soapClient->getSoapClient()); } catch (\Exception $e) { var_dump($e->getCode(), $e->getMessage()); }, <sub>(*7)</sub>

// set mandatory info $encryptParameter = new EncryptParameter(); $encryptParameter->shopLogin = 'GESPAY12345'; $encryptParameter->amount = '1.23'; $encryptParameter->shopTransactionId = '1'; $encryptParameter->uicCode = Data\Currency::EUR; $encryptParameter->languageId = Data\Language::ITALIAN;, <sub>(*8)</sub>

// set optional custom info as array $customArray = array('STORE_ID' => '42', 'STORE_NAME' => 'Shop Abc123'); $encryptParameter->setCustomInfo($customArray);, <sub>(*9)</sub>

// encrypt data $encryptResult = $gestpay->encrypt($encryptParameter);, <sub>(*10)</sub>

// get redirect link to Banca Sella echo $encryptResult->getPaymentPageUrl($encryptParameter->shopLogin, $soapClient->wsdlEnvironment);, <sub>(*11)</sub>

### Decrypt
``` php
require __DIR__ . '/../vendor/autoload.php';

use EndelWar\GestPayWS\Parameter\DecryptParameter;
use EndelWar\GestPayWS\WSCryptDecryptSoapClient;
use EndelWar\GestPayWS\WSCryptDecrypt;

// $_GET['a'] and $_GET['b'] are received from Banca Sella
$param = array(
    'shopLogin' => $_GET['a'],
    'CryptedString' => $_GET['b']
);

$decryptParam = new DecryptParameter($param);

// enable or disable test environment
$enableTestEnv = true;
$soapClient = new WSCryptDecryptSoapClient($enableTestEnv);
try {
    $gestpay = new WSCryptDecrypt($soapClient->getSoapClient());
    $decryptResult = $gestpay->decrypt($decryptParam);

    echo $decryptResult->TransactionResult;
} catch (\Exception $e) {
    var_dump($e->getCode(), $e->getMessage());
}

Testing

EndelWar/GestPayWS has a PHPUnit test suite. To run the tests, run the following command from the project folder., <sub>(*12)</sub>

bash $ vendor/bin/phpunit, <sub>(*13)</sub>

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Versioning

Semantic versioning (semver) is applied., <sub>(*14)</sub>

License

This library is under the MIT license. For the full copyright and license information, please view the LICENSE file that was distributed with this source code., <sub>(*15)</sub>