Skip to content
This repository has been archived by the owner on Dec 2, 2024. It is now read-only.

Separate card payment, Added sandbox #63

Merged
merged 7 commits into from
Aug 31, 2017
Merged

Separate card payment, Added sandbox #63

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
0988d2f
Separate cart payment
regdos Aug 27, 2017
b164924
New readme, remove PayU info from card payment
regdos Aug 28, 2017
6a13301
Cleanup readme
regdos Aug 28, 2017
ca0c2e5
en translation update
lukasz-grzesiak-payu-gpo Aug 29, 2017
add0dfd
Added Sandbox
regdos Aug 29, 2017
d089f45
Fix extract language from locale
regdos Aug 31, 2017
acf9176
Update changelog
regdos Aug 31, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
## 2.3.0
* Separated card payment
* Added sandbox

## 2.2.1
* Fix customerIp and translate
* Catch consumeNotification exception
Expand Down
115 changes: 115 additions & 0 deletions README.EN.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
[**Wersja polska**][ext0]

# PayU account plugin for Magento 1.6.0+
``This plugin is released under the GPL license.``

**If you have any questions or issues, feel free to contact our technical support: tech@payu.pl.**

## Table of Contents

1. [Features](#features)
1. [Prerequisites](#prerequisites)
1. [Installation](#installation)
1. [Configuration](#configuration)
* [Parameters](#parameters)

## Features
The PayU payments Magento plugin adds the PayU payment option and enables you to process the following operations in your e-shop:
* Creating a payment order (with discounts included)
* Receive or canceling a payment order (when auto-receive is disable)
* Conducting a refund operation (for a whole or partial order)

The module adds two payment methods:

![methods][img0]
* **Pay with PayU** - redirection to PayU hosted paywall (with all available payment methods)
* **Pay by card** - redirection to PayU hosted card payment form

# Prerequisites

**Important:** This plugin works only with REST API (checkout) points of sales (POS).

The following PHP extensions are required:

* [cURL][ext2] to connect and communicate to many different types of servers with many different types of protocols.
* [hash][ext3] to process directly or incrementally the arbitrary length messages by using a variety of hashing algorithms.

## Installation

### Option 1
**Intended for users with FTP access to Magento Installation**

1. Download the module from [repozytorium GitHub][ext3] as zip file.
1. Unzip the file.
1. Connect with your FTP server and copy `app`, `lib` and `skin` directories from the unzipped file to the main directory of your Magento installation.
1. Flush the cache to update the available plugins list:
* Go to admin page of your Magento installation [http://shop-url/admin].
* Choose **System** > **Cache Management**.
* Click **Flush Magento Cache** button.
1. If you are using compilation option, choose **System** > **Tools** > **Compilation** and click **Run Compilation Process** button.

### Option 2
**Using Magento Connect**

1. Go to admin page of your Magento installation [http://shop-url/admin].
1. Choose **System** > **Magento Connect** > **Magento Connect Manager**.
1. In **Install New Extensions section** insert `http://connect20.magentocommerce.com/community/PayU_Account` into the `Paste the extension key to install` field and click `Install`
1. Information about the plugin shall appear shortly. To continue installation click `Proceed`.

### Option 3
**Using modman script**

PayU module includes configuration which makes it possible to install via `modman` script.
Please refer to `modman` documentation for further details.

## Configuration

Independently of the installation method, the configuration looks the same:

1. Go to the Magento administration page [http://shop-url/admin].
2. Go to **System** > **Configuration**.
3. From the **Configuration** menu on the left, in the **Sales** section, select **Payment Methods**.
4. In the list of available methods, click **PayU** or **PayU - cards** to expand the configuration form.
5. Click `Save config`.

### Parameters

#### Main parameters

| Parameter | Description |
|---------|-----------|
| Enable plugin? | Defines the availability of the payment method on the payment method list during checkout. |
| Sandbox mode | Defines if payments will be created in PayU sandbox instead of production (live) environment. |

#### POS parameters

| Parameter | Description |
|---------|-----------|
|POS ID|Unique ID of the POS|
|Second Key|MD5 key for securing communication|
|OAuth - client_id|client_id for OAuth|
|OAuth - client_secret|client_secret for OAuth|

#### POS parameters - Sandbox mode
Available when parameter `Sandbox mode` is set to `Yes`.

| Parameter | Description |
|---------|-----------|
|POS ID|Unique ID of the POS|
|Second Key|MD5 key for securing communication|
|OAuth - client_id|client_id for OAuth|
|OAuth - client_secret|client_secret for OAuth|


<!--LINKS-->

<!--topic urls:-->

<!--external links:-->
[ext0]: README.md
[ext1]: https://github.com/PayU/plugin_magento_160
[ext2]: http://php.net/manual/en/book.curl.php
[ext3]: http://php.net/manual/en/book.hash.php

<!--images:-->
[img0]: readme_images/methods_en.png
158 changes: 77 additions & 81 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,116 +1,112 @@
# PayU account plugin for Magento 1.6.0+
-------
``This plugin is released under the GPL license.``
[**English version**][ext0]

**If you have any questions or issues, feel free to contact our technical support: tech@payu.pl.**
# Moduł PayU dla Magento 1.6.0+
``Moduł jest wydawany na licencji GPL.``

## Table of Contents
**Jeżeli masz jakiekolwiek pytania lub chcesz zgłosić błąd zapraszamy do kontaktu z naszym wsparciem pod adresem: tech@payu.pl.**

1. [Features](#features)
1. [Prerequisites](#prerequisites)
1. [Installation](#installation)
* [Installing Manually](#installing-manually)
* [Installing with Magento Connect](#installing-with-magento-connect)
1. [Configuration](#configuration)
## Spis treści

##Features
The PayU payments Magento plugin adds the PayU payment option and enables you to process the following operations in your e-shop:
1. [Cechy](#cechy)
1. [Wymagania](#wymagania)
1. [Instalacja](#instalacja)
1. [Konfiguracja](#konfiguracja)
* [Parametry](#parametry)

* Creating a payment order (with discounts included)
* Receive or canceling a payment order (when auto-receive is disable)
* Conducting a refund operation (for a whole or partial order)
## Cechy
Moduł płatności PayU dodaje do Magento opcję płatności PayU.

##Prerequisites
Możliwe są następujące operacje:
* Utworzenie płatności (wraz z rabatami)
* Odebranie lub odrzucenie płatności (w przypadku wyłączonego autoodbioru)
* Utworzenie zwrotu online (pełnego lub częściowego)

**Important:** This plugin works only with REST API (checkout) points of sales (POS).

The following PHP extensions are required:

* [cURL][ext2] to connect and communicate to many different types of servers with many different types of protocols.
* [hash][ext3] to process directly or incrementally the arbitrary length messages by using a variety of hashing algorithms.

##Installation

There are two ways in which you can install the plugin:
Moduł dodaje dwie metody płatności:

![methods][img0]
* **Zapłać przez PayU** - przekierowanie na stronę wyboru metod płatności w PayU
* **Zapłać kartą** - bezpośrednie przekierowanie na formularz płatności kartą

* [manual installation](#installing-manually) by copying and pasting folders from the repository
* [Magento Connect installation](#installing-with-magento-connect) from the administration page
## Wymagania

See the sections below to find out about steps for each of the procedures.
**Ważne:** Moduł ten działa tylko z punktem płatności typu `REST API` (Checkout).

###Installing Manually
Do prawidłowego funkcjonowania modułu wymagane są następujące rozszerzenia PHP: [cURL][ext1] i [hash][ext2].

To install the plugin manually, simply copy folders and refresh the list of plugins:
## Instalacja

1. Copy the folders from [the plugin repository][ext1] to your Magento root folder on the server.
1. In order to update the list of available plugins, clean the cache:
* Go to the Magento administration page [http://your-magento-url/admin].
* Go to **System** > **Cache Management**.
* Select all cache types and click the **Flush Magento Cache** button.<br />
**Note:** If the list of plugins doesn't refresh, flush other cache as well.
### Opcja 1
**Przeznaczona dla użytkowników z dostępem poprzez FTP do instalacji Magento**

**Results**<br /> ![cache_flush_cusscess][img3]<br />
3. If you have enabled compilation **System** > **Tools** > **Compilation** you have to click **Run Compilation Process**.
1. Pobierz moduł z [repozytorium GitHub][ext3] jako plik zip
1. Rozpakuj pobrany plik
1. Połącz się z serwerem ftp i skopiuj katalogi `app`, `lib` oraz `skin` z rozpakowanego pliku do katalogu głównego swojego sklepu Magento
1. W celu aktualizacji listy dostępnych wtyczek należy wyczyścić cache:
* Przejdź do strony administracyjnej swojego sklepu Magento [http://adres-sklepu/admin].
* Przejdź do **System** > **Cache Management**.
* Naciśnij przycisk **Flush Magento Cache**.
1. Jeżeli używasz opcji kompilacji po przejściu do **System** > **Tools** > **Compilation** należy nacisnąć przycisk **Run Compilation Process**.

###Installing with Magento Connect
### Opcja 2
**Z użyciem Magento Connect**

The Mangento Connect tool allows you to install the plugin from the administration page.
1. Przejdź do strony administracyjnej swojego sklepu Magento [http://adres-sklepu/admin].
1. Przejdź do **System** > **Magento Connect** > **Magento Connect Manager**.
1. W sekcji **Install New Extensions section** do pola `Paste the extension key to install` należy wkleić `http://connect20.magentocommerce.com/community/PayU_Account` i wcisnąć przycisk `Install`
1. Po chwili pojawi się informacji o wtyczce. W celu instalacji należy nacisnąć przycisk `Proceed`

**Before you start**<br />
It is recommended to always backup your installation prior to use.
### Opcja 3
**Z użyciem skryptu modman**

1. Go to Magento administration page [http://your-magento-url/admin].
2. Go to **System** > **Magento Connect** > **Magento Connect Manager**.
3. In the Install New Extensions section, click Search for modules via Magento Connect.<br />
*Option:* Paste the extension key to install.
4. Use the search box to find PayU.
5. Click the **PayU** icon and install the plugin by clicking the **Install Now** button.<br />
**Note:** If you are new to Magento Connect, when you click **Install Now** you are asked to register and log in to get the extension key.<br />

##Configuration
Moduł PayU zawiera konfigurację umożliwiającą instalację poprzez skrypt `modman`.
W celu instalcji z użyciem `modman` proszę skozystać z dokumentacji skryptu `modman`.

Independently of the installation method, the configuration looks the same:
## Konfiguracja

1. Go to the Magento administration page [http://your-magento-url/admin].
2. Go to **System** > **Configuration** window.
3. From the **Configuration** menu on the left, in the **Sales** section, select **Payment Methods**.
4. In the list of available methods, click PayU to expand the configuration form, and specify the [configuration parameters](#configuration).
5. Click ![save_config][img2] in the top right corner of the page.
1. Przejdź do strony administracyjnej swojego sklepu Magento [http://adres-sklepu/admin].
1. Przejdź do **System** > **Configuration**.
3. Na stronie **Configuration** w menu po lewej stronie w sekcji **Sales** wybierz **Payment Methods**.
4. Na liście dostępnych metod płatności należy wybrać **PayU** lub **PayU - karty** w celu konfiguracji parametrów wtyczki.
5. Naciśnij przycisk `Save config`.

### Configuration Parameters
### Parametry

The tables below present the descriptions of the configuration form parameters.
#### Główne parametry

#### Main parameters
| Parameter | Opis |
|---------|-----------|
| Czy włączyć wtyczkę? | Określa czy metoda płatności będzie dostępna w sklepie na liście płatności. |
| Tryb testowy (Sandbox) | Określa czy płatności będą realizowane na środowisku testowym (sandbox) PayU. |

The main parameters for plugin configuration are as follows:
#### Parametry punktu płatności (POS)

| Parameter | Values | Description |
|:---------:|:------:|:-----------:|
|Enabled|Yes/No|Specifies whether the module is enabled.|
| Parameter | Opis |
|---------|-----------|
| Id punktu płatności| Identyfikator POS-a z systemu PayU |
| Drugi klucz MD5 | Drugi klucz MD5 z systemu PayU |
| OAuth - client_id | client_id dla protokołu OAuth z systemu PayU |
| OAuth - client_secret | client_secret for OAuth z systemu PayU |

#### POS parameters
#### Parametry punktu płatności (POS) - Tryb testowy (Sandbox)
Dostępne gdy parametr `Tryb testowy (Sandbox)` jest ustawiony na `Tak`.

To check the values of the parameters below, go to **Administration Panel** > **My shops** > **Your shop** > **POS** and click the name of a given POS.
| Parameter | Opis |
|---------|-----------|
| Id punktu płatności| Identyfikator POS-a z systemu PayU |
| Drugi klucz MD5 | Drugi klucz MD5 z systemu PayU |
| OAuth - client_id | client_id dla protokołu OAuth z systemu PayU |
| OAuth - client_secret | client_secret for OAuth z systemu PayU |

| Parameter | Description |
|:---------:|:-----------:|
|POS ID|Unique ID of the POS|
|Second Key|MD5 key for securing communication|
|OAuth - client_id|client_id for OAuth|
|OAuth - client_secret|client_secret for OAuth|

<!--LINKS-->

<!--topic urls:-->

<!--external links:-->

[ext1]: https://github.com/PayU/plugin_magento_160
[ext2]: http://php.net/manual/en/book.curl.php
[ext3]: http://php.net/manual/en/book.hash.php
[ext0]: README.EN.md
[ext1]: http://php.net/manual/en/book.curl.php
[ext2]: http://php.net/manual/en/book.hash.php
[ext3]: https://github.com/PayU/plugin_magento_160

<!--images:-->

[img2]: https://raw.github.com/PayU/plugin_magento_160/master/readme_images/save_config.png
[img3]: https://raw.github.com/PayU/plugin_magento_160/master/readme_images/cache_flushed.png
[img0]: readme_images/methods.png
24 changes: 24 additions & 0 deletions app/code/community/PayU/Account/Block/Adminhtml/Block/System/Config/Form/Fieldset.php
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
<?php

class Payu_Account_Block_Adminhtml_Block_System_Config_Form_Fieldset extends Mage_Adminhtml_Block_System_Config_Form_Fieldset
{

/**
* Return header title part of html for payment solution
*
* @param Varien_Data_Form_Element_Abstract $element
* @return string
*/
protected function _getHeaderTitleHtml($element)
{
$html = '<div class="entry-edit-head collapseable" ><a id="' . $element->getHtmlId()
. '-head" href="#" style="line-height: 21px" onclick="Fieldset.toggleCollapse(\'' . $element->getHtmlId() . '\', \''
. $this->getUrl('*/*/state') . '\'); return false;">';

$html .= ' <img src="'.$this->getSkinUrl('images/payu/payu_logo.png').'" height="21" style="vertical-align: bottom; margin-right: 5px;"/> ';
$html .= $element->getLegend();

$html .= '</a></div>';
return $html;
}
}
Loading