Develop

.php-cs-fixer.php

@@ -1,15 +1,15 @@
 <?php
 
 $finder = PhpCsFixer\Finder::create()
-    ->in(__DIR__.'/src')
-    ->in(__DIR__.'/test');
+    ->in(__DIR__ . '/src')
+    ->in(__DIR__ . '/test');
 
 $config = new PhpCsFixer\Config();
 return $config
     ->setUsingCache(false)
     ->setRules(
         array(
-            '@PSR2' => true,
+            '@PSR12' => true,
             'no_blank_lines_after_phpdoc' => true,
             'phpdoc_add_missing_param_annotation' => true,
             'native_function_casing' => true,
@@ -21,11 +21,11 @@
             'multiline_whitespace_before_semicolons' => true,
             'no_singleline_whitespace_before_semicolons' => true,
             'no_spaces_around_offset' => true,
-            'no_trailing_comma_in_singleline_array' => true,
+            'no_trailing_comma_in_singleline' => true,
             'no_unused_imports' => true,
             'normalize_index_brace' => true,
             'phpdoc_align' => true,
             'phpdoc_separation' => true,
         )
     )
-    ->setFinder($finder);
+    ->setFinder($finder);

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and this project adheres
 to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [3.3.0](https://github.com/unzerdev/php-sdk/compare/3.2.0..3.3.0)
+### Added
+*   Chargeback transaction type.
+    *   Add class `\UnzerSDK\Resources\TransactionTypes\Chargeback`.
+    *   Add methods `\UnzerSDK\Unzer::fetchChargeback` and `\UnzerSDK\Unzer::fetchChargebackById` to fetch chargeback information.
+*   Add `\UnzerSDK\Resources\PaymentTypes\PayU` payment type.
+*   Add example for PayU payment type.
+
 ## [3.2.0](https://github.com/unzerdev/php-sdk/compare/3.1.0..3.2.0)
 
 ### Added

examples/PayU/Constants.php

@@ -0,0 +1,28 @@
+<?php
+
+/**
+ * This file defines the constants needed for the PayU example.
+ *
+ * Copyright (C) 2020 - today Unzer E-Com GmbH
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @link  https://docs.unzer.com/
+ *
+ * @package  UnzerSDK\examples
+ */
+
+require_once __DIR__ . '/../Constants.php';
+
+define('EXAMPLE_URL', EXAMPLE_BASE_FOLDER . 'PayU');
+define('CONTROLLER_URL', EXAMPLE_URL . '/Controller.php');

examples/PayU/Controller.php

@@ -0,0 +1,83 @@
+<?php
+/**
+ * This is the controller for the PayU example.
+ * It is called when the pay button on the index page is clicked.
+ *
+ * Copyright (C) 2020 - today Unzer E-Com GmbH
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @link  https://docs.unzer.com/
+ *
+ * @package  UnzerSDK\examples
+ */
+
+/** Require the constants of this example */
+require_once __DIR__ . '/Constants.php';
+
+/** @noinspection PhpIncludeInspection */
+/** Require the composer autoloader file */
+require_once __DIR__ . '/../../../../autoload.php';
+
+use UnzerSDK\examples\ExampleDebugHandler;
+use UnzerSDK\Exceptions\UnzerApiException;
+use UnzerSDK\Unzer;
+
+session_start();
+session_unset();
+
+$clientMessage = 'Something went wrong. Please try again later.';
+$merchantMessage = 'Something went wrong. Please try again later.';
+
+function redirect($url, $merchantMessage = '', $clientMessage = '')
+{
+    $_SESSION['merchantMessage'] = $merchantMessage;
+    $_SESSION['clientMessage']   = $clientMessage;
+    header('Location: ' . $url);
+    die();
+}
+
+// You will need the id of the payment type created in the frontend (index.php)
+if (!isset($_POST['resourceId'])) {
+    redirect(FAILURE_URL, 'Resource id is missing!', $clientMessage);
+}
+$paymentTypeId   = $_POST['resourceId'];
+
+// Catch API errors, write the message to your log and show the ClientMessage to the client.
+try {
+    // Create an Unzer object using your private key and register a debug handler if you want to.
+    $unzer = new Unzer(UNZER_PAPI_PRIVATE_KEY);
+    $unzer->setDebugMode(true)->setDebugHandler(new ExampleDebugHandler());
+
+    // Create a charge transaction to get the redirectUrl.
+    $transaction = new \UnzerSDK\Resources\TransactionTypes\Charge(12.32, 'PLN', RETURN_CONTROLLER_URL);
+    $unzer->performCharge($transaction, $paymentTypeId);
+
+    // You'll need to remember the paymentId for later in the ReturnController
+    $_SESSION['PaymentId'] = $transaction->getPaymentId();
+    $_SESSION['ShortId']   = $transaction->getShortId();
+
+    // Redirect to the PayU page
+    if (!$transaction->isError() && $transaction->getRedirectUrl() !== null) {
+        redirect($transaction->getRedirectUrl());
+    }
+
+    // Check the result message of the charge to find out what went wrong.
+    $merchantMessage = $transaction->getMessage()->getCustomer();
+} catch (UnzerApiException $e) {
+    $merchantMessage = $e->getMerchantMessage();
+    $clientMessage = $e->getClientMessage();
+} catch (RuntimeException $e) {
+    $merchantMessage = $e->getMessage();
+}
+redirect(FAILURE_URL, $merchantMessage, $clientMessage);

examples/PayU/index.php

@@ -0,0 +1,87 @@
+<?php
+/**
+ * This file provides an example implementation of the PayU payment type.
+ *
+ * Copyright (C) 2020 - today Unzer E-Com GmbH
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @link  https://docs.unzer.com/
+ *
+ * @package  UnzerSDK\examples
+ */
+
+/** Require the constants of this example */
+require_once __DIR__ . '/Constants.php';
+
+/** @noinspection PhpIncludeInspection */
+/** Require the composer autoloader file */
+require_once __DIR__ . '/../../../../autoload.php';
+?>
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <title>Unzer UI Examples</title>
+    <script src="https://code.jquery.com/jquery-3.6.0.min.js"
+            integrity="sha256-/xUj+3OJU5yExlq6GSYGSHk7tPXikynS7ogEvDej/m4="
+            crossorigin="anonymous"></script>
+
+    <link rel="stylesheet" href="https://static.unzer.com/v1/unzer.css" />
+    <script type="text/javascript" src="https://static.unzer.com/v1/unzer.js"></script>
+</head>
+
+<body style="margin: 70px 70px 0;">
+
+<p><a href="https://docs.unzer.com/reference/test-data" target="_blank">Click here to open our test data in new tab.</a></p>
+
+<form id="payment-form" class="unzerUI form" novalidate>
+    <div class="field" id="error-holder" style="color: #9f3a38"> </div>
+    <div class="field">
+        <button class="unzerUI primary button fluid" id="submit-button" type="submit">Pay</button>
+    </div>
+</form>
+
+<script>
+    // Create an Unzer instance with your public key
+    let unzerInstance = new unzer('<?php echo UNZER_PAPI_PUBLIC_KEY; ?>');
+
+    // Create an PayU instance
+    let payU = unzerInstance.PayU();
+
+    // Handle payment form submission
+    let form = document.getElementById('payment-form');
+    form.addEventListener('submit', function(event) {
+        event.preventDefault();
+        // Creating a payU resource
+        payU.createResource()
+            .then(function(result) {
+                let hiddenInput = document.createElement('input');
+                hiddenInput.setAttribute('type', 'hidden');
+                hiddenInput.setAttribute('name', 'resourceId');
+                hiddenInput.setAttribute('value', result.id);
+                form.appendChild(hiddenInput);
+                form.setAttribute('method', 'POST');
+                form.setAttribute('action', '<?php echo CONTROLLER_URL; ?>');
+
+                // Submitting the form
+                form.submit();
+            })
+            .catch(function(error) {
+                $('#error-holder').html(error.message)
+            })
+    });
+</script>
+</body>
+</html>

examples/index.php

@@ -295,6 +295,18 @@ function printMessage($type, $title, $text)
                         Try
                     </div>
                 </div>
+                <div class="card olive">
+                    <div class="content">
+                        <div class="header">
+                            PayU
+                        </div>
+                        <div class="description">
+                        </div>
+                    </div>
+                    <div id="tryPayUExample" class="ui bottom attached green button" onclick="location.href='PayU/';">
+                        Try
+                    </div>
+                </div>
                 <div class="card olive">
                     <div class="content">
                         <div class="header">

phpunit.xml

@@ -1,5 +1,6 @@
 <?xml version="1.0"?>
-<phpunit backupGlobals="false"
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         backupGlobals="false"
          backupStaticAttributes="false"
          bootstrap="test/bootstrap.php"
          colors="false"
@@ -8,16 +9,17 @@
          convertWarningsToExceptions="false"
          processIsolation="false"
          stopOnFailure="false"
-         verbose="true">
+         verbose="true"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd">
+    <coverage processUncoveredFiles="true">
+        <include>
+            <directory suffix=".php">src/</directory>
+        </include>
+    </coverage>
     <groups>
         <exclude>
             <group>disabled</group>
             <group>skip</group>
         </exclude>
     </groups>
-    <filter>
-        <whitelist processUncoveredFilesFromWhitelist="true">
-            <directory suffix=".php">src/</directory>
-        </whitelist>
-    </filter>
-</phpunit>
+</phpunit>

src/Adapter/ApplepayAdapter.php

@@ -1,4 +1,5 @@
 <?php
+
 /** @noinspection PhpComposerExtensionStubsInspection */
 
 /**
@@ -22,6 +23,7 @@
  *
  * @package  UnzerSDK\Adapter
  */
+
 namespace UnzerSDK\Adapter;
 
 use UnzerSDK\Constants\ApplepayValidationDomains;

src/Adapter/CurlAdapter.php

@@ -1,4 +1,5 @@
 <?php
+
 /** @noinspection PhpComposerExtensionStubsInspection */
 /**
  * This is a wrapper for the default http adapter (CURL).
@@ -21,13 +22,15 @@
  *
  * @package  UnzerSDK\Adapter
  */
+
 namespace UnzerSDK\Adapter;
 
 use UnzerSDK\Unzer;
 use UnzerSDK\Services\EnvironmentService;
-use function extension_loaded;
 use UnzerSDK\Exceptions\UnzerApiException;
 use RuntimeException;
+
+use function extension_loaded;
 use function in_array;
 
 class CurlAdapter implements HttpAdapterInterface

src/Adapter/HttpAdapterInterface.php

@@ -20,6 +20,7 @@
  *
  * @package  UnzerSDK\Adapter
  */
+
 namespace UnzerSDK\Adapter;
 
 use UnzerSDK\Exceptions\UnzerApiException;

src/Constants/AdditionalAttributes.php

@@ -21,6 +21,7 @@
  *
  * @package  UnzerSDK\Constants
  */
+
 namespace UnzerSDK\Constants;
 
 class AdditionalAttributes

src/Constants/AdditionalTransactionDataKeys.php

@@ -20,6 +20,7 @@
  *
  * @package  UnzerSDK\Constants
  */
+
 namespace UnzerSDK\Constants;
 
 class AdditionalTransactionDataKeys

src/Constants/ApiResponseCodes.php

@@ -20,6 +20,7 @@
  *
  * @package  UnzerSDK\Constants
  */
+
 namespace UnzerSDK\Constants;
 
 class ApiResponseCodes

src/Constants/ApplepayValidationDomains.php

@@ -20,6 +20,7 @@
  *
  * @package  UnzerSDK\Constants
  */
+
 namespace UnzerSDK\Constants;
 
 class ApplepayValidationDomains

src/Constants/BasketItemTypes.php

@@ -20,6 +20,7 @@
  *
  * @package  UnzerSDK\Constants
  */
+
 namespace UnzerSDK\Constants;
 
 class BasketItemTypes

src/Constants/CancelReasonCodes.php

@@ -20,6 +20,7 @@
  *
  * @package  UnzerSDK\Constants
  */
+
 namespace UnzerSDK\Constants;
 
 class CancelReasonCodes