https://github.com/payneteasy/woocommerce-pne-module
Payneteasy Payment Gateway Module for wooCommerce CMS
https://github.com/payneteasy/woocommerce-pne-module
Last synced: 20 days ago
JSON representation
Payneteasy Payment Gateway Module for wooCommerce CMS
- Host: GitHub
- URL: https://github.com/payneteasy/woocommerce-pne-module
- Owner: payneteasy
- License: mit
- Created: 2019-02-07T13:30:03.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-08-29T06:55:31.000Z (almost 3 years ago)
- Last Synced: 2025-07-18T02:49:49.025Z (about 1 year ago)
- Language: PHP
- Size: 5.92 MB
- Stars: 1
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-eng.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Content
## [WordPress Installation](#wordpress-installation-1)
## [WooCommerce plugin installation](#woocommerce-plugin-installation-1)
## [Payneteasy Gateway plugin installation and configuration](#payneteasy-gateway-plugin-installation-and-configuration-1)
## [Product creating process](#product-creating-process-1)
## [Payment Flow](#payment-flow-1)
## [List of errors](#list-of-errors-1)
- ***Tested on WooCommerce v 8.0.1***
# WordPress Installation
1. Login to [admin WordPress panel](http://wordpress.org/wp-admin/).
2. Select the language.
3. Start WordPress installation.
4. Provide the name of the database and user created earlier.
5. Run the installation.
6. Set the site name, username and password.
7. Finish the installation process.
# WooCommerce plugin installation
1. Go to the [**Plugins**](http://wordpress.org/wp-admin/plugins.php) tab and click the `Add New` button.
2. Find the *wooCommerce* plugin in the search field.
3. Install it by clicking `Install Now` button.
4. Activate the plugin. Click on the `Activate` button.
5. Select the Industry field, type of products and region and click `Continue` button.
# Payneteasy Gateway plugin installation and configuration
1. In the **/wp-content/plugins/** folder create directory **paynet-easy-gateway**.
```bash
cd /wp-content/plugins/
mkdir paynet-easy-gateway
```
2. Recursively copy the **wooCommerce-pne-module** directory content (not the directory itself) to the directory **/wp-content/plugins/paynet-easy-gateway**.
```bash
cp -r wooCommerce-pne-module/* /wp-content/plugins/paynet-easy-gateway
```
Content of the directory *wooCommerce-pne-module*
* admin
* docs
* images
* index.php
* languages
* LICENSE.txt
* PaynetEasy
* paynet-easy-gateway.php
* public
* README.md
* templates
* uninstall.php
3. Go to the **Plugins** tab and activate *Payneteasy Gateway* plugin by clicking `Activate` button.
4. Go to the *WooCommerce* plugin `1` payment customization page [**Woocommerce/Settings/Payments**](http://wordpress.org/wp-admin.php?page=wc-settings&tab=checkout) `2`, `3`. Enable *Payneteasy Method* `4` and drag it to the top `5`. Save changes.
5. Go to the [*Payneteasy Gateway* plugin customization page](http://wordpress.org/wp-admin/admin.php?page=wc-settings&tab=checkout§ion=payneteasy) by clicking on it.
| Parameter | Description |
|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Enable/Disable | Enable or disable PaynetEasy Gateway plugin |
| Title | This field controls the title which the user sees during checkout |
| Description | This field controls the description which the user sees during checkout |
| Sandbox test mode | Place the payment gateway in development mode |
| Log level | One of the log levels must be chosen: `EMERGENCY`, `ALERT`, `CRITICAL`, `ERROR`, `WARNING`, `NOTICE`, `INFO`, `DEBUG` |
| Integration mode | Acceptance of payment details is implemented on the PaynetEasy gateway side. One of the integration methods must be chosen: `Inline form`, `Remote` |
| End point | The End point ID is an entry point for incoming Connecting Party’s transactions for single currency integration. Either End point or End point group must be used |
| End point group | The End point group ID is an entry point for incoming Merchant’s transactions for multi-currency integration. Either End point or End point group must be used |
| Login | Connecting Party’s login name |
| Control key | Connecting Party’s control string for sign |
| Gateway url | Payment Gateway's URL |
**Note** For sandbox mode all sandbox parameters must be used.
# Product creating process
Go to the **Products** tab on the Sidebar and create a new product.
Product parameters that should be filled:
* Name `1`
* Description `2`
* Price `3`
* After all fields are filled, press the `Publish` `4` button to publish the product.
# Payment Flow
1. Enter to the `Shop` and start the Payment Flow.
2. Add a product to the card by clicking on the `Add to card` button and then view the card.
3. Select the quantity of the product and click on `Proceed to checkout` button to start the payment process.
4. Fill the payment form and press the `Place Order` button.
| Parameter | Description |
|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|
| First name | Payer's first name |
| Last name | Payer's last name |
| Country/Regional | Payer's country |
| Street address | Payer's address line |
| Town/City | Payer's city |
| State/Country | Payer's state |
| Postcode/ZIP | Payer's ZIP code |
| Phone | Payer's full international number, including country code |
| E-mail address | Payer's e-mail address |
| Card number | Payer's credit card number |
| Card printed name | Cardholder name, printed on the bank card |
| Expiry month | Bank card expiration month |
| Expiry year | Bank card expiration year |
| Card Code (CVC) | Payer's CVV2 code. CVV2 (Card Verification Value) is a three- or four-digit number AFTER the credit card number in the signature area of the card |
5. Start the redirecting process.
6. The payer is redirecting to the wait form.
7. The payer is redirecting to the finish form.
# List of errors
1. **Error:** `Callback URL cannot be local or private`
**Solution**
In the **/var/www/html/wp-content/plugins/paynet-easy-gateway/PaynetEasy/WoocommerceGateway/WCIntegration.php** file replace the local IP `home_url('/')` with external URL or IP, for example, `https://httpstat.us/200`.
2. **Error:** `Project with X currency doest not apply request with currency Y`
**Solution**
Incorrect currency. WooCommerce currency should match to the Payment Gateway's endpoint currency. It can be changed in the [WooCommerce general currency settings](http://wordpress.org/wp-admin/admin.php?page=wc-settings)
3. **Error:** `Amount is less/higher than minimum/maximum X`
**Solution**
Endpoint limits must be checked.
4. **Error:** `Internal server error`
**Solution**
WooCommerce system files must be checked. Most likely, the problem in the .php files - incorrect manual configurations, damaged files etc. Good solution is updating or reinstalling the repository.
5. **Error:** `Error occured. HTTP code: '50x'`
**Solution**
Gateway URL parameter in *Payneteasy Gateway* plugin configurations must be corrected. Example: *https://sandbox.payneteasy.eu/paynet/api/v2*.
6. **Error:** `Property 'signingKey' does not defined in PaymentTransaction property 'queryConfig'`
**Solution**
Incorrect merchant Control Key. [Payneteasy Gateway settings](http://wordpress.org/wp-admin/admin.php?page=wc-settings&tab=checkout§ion=payneteasy) must me checked.
7. **Error:** `Some Request fields are invalid: Gateway url does not valid in Request`
**Solution**
Incorrect Gateway url. [Payneteasy Gateway settings](http://wordpress.org/wp-admin/admin.php?page=wc-settings&tab=checkout§ion=payneteasy) must me checked.
8. **Error:** `End point with id 0 not found`
**Solution**
Incorrect Endpoint or Login field is empty/incorrect. [Payneteasy Gateway settings](http://wordpress.org/wp-admin/admin.php?page=wc-settings&tab=checkout§ion=payneteasy) must me checked.