Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


UI Steps


UI Step

Requirements

An active PAYONE - Account is required. If you do not have one yet, please contact us.


UI Step

Plugin Installation

You can download the latest version from our Github repository:

Section


Column
width33%



Column
width33%

UI Button
colorgreen
newWindowtrue
sizelarge
displayblock
icondownload
titleDownload from Github
urlhttps://github.com/PAYONE-GmbH/prestashop-17/releases


Column
width33%



Extract the contents of the .zip file into a new folder named "fcpayone" in the "modules" folder of your Prestashop directory. Pay attention to the correct read and write permissions on the server!


UI Step

PAYONE - Portal configuration

To send the transaction status to the correct address, the log in to the PAYONE Merchant Interface (PMI).


Under Configuration → Payment Portals → YOUR_PORTAL → Advanced → TransactionStatus URL

UI Text Box
typeinfo
<SHOPURL>/modules/fcpayone/status.php?id_shop=1

Additional Response-data

Under General, set the Additional Response data for both Live and Test modes to "on".


UI Step

Prestashop - Admin configuration

  • The plugin appears in the "Selection" tab in the plugin administration of the shop for installation.

  • Once the module is installed, you can configure it using the "Settings" button.

  • You can configure the basic configuration of the module in the Settings tab → Connection settings

UI Expand
titleDetailed description of each field

Detailed description of each field


Field

Description

active

  • yes - activates the PAYONE module
  • no - deactivates the module

PAYONE Live Mode

Here you can specify for the respective payment type whether the payments are to be processed in test mode or whether they are to be executed "live". You can also configure the test mode for individual payment types.

PAYONE Merchant ID

You will find your PAYONE Merchant ID at the top right of the PAYONE Merchant Interface (PMI) and on all PAYONE invoices.

PAYONE Portal ID

You can find the portal ID in the PAYONE Merchant Interface (PMI) under the menu item Configuration → Payment Portals

PAYONE Portal KeyPlease enter the key here to protect the data communication against manipulation. This must be identical to the key stored in the corresponding PAYONE payment portal.

PAYONE Sub-Account ID

You can find the ID in the PAYONE Merchant Interface (PMI) under the menu item Configuration → Accounts

Reference number Prefix

specifies a prefix that is placed before the purchase order number. Example: The prefix "BST_" leads to the following order number: "BST_123".



Special adjustments

Some payment methods require special adjustments. The next points are only relevant to you if you use the specific payment method:

UI Expand
titleCreditcard

Creditcard

These settings are specific to credit card payment types.

General information

Field

Description

Display CVC

Determines whether the card CVC Code (CVC, CVV) is queried during checkout.

UI Text Box
typeinfo

This field is technically optional, but we recommend that you always query the CVC!




UI Expand
titlePAYONE Direct debit

PAYONE Direct debit

Field

Description

also display account number/bank code number

Legacy field from the changeover phase. Please leave on NO.

Display BIC field

determines whether the field for the BIC is to be displayed.

UI Text Box
typeinfo

Helpful for orders with accounts outside the DACH area.




UI Expand
titlePayPal Express Checkout

PayPal Express Checkout



Field

Description

PayPal Express Button Image

Here you can upload an image file that contains the PayPal Express Checkout link in your shopping cart.



UI Expand
titleSofort

Sofort

Field

Description

Display IBAN/BIC fields

Legacy field from the changeover phase. Please leave on NO.




UI Step

Payment methods setup

You can make these configurations for each payment type:

Field

Description

active

Determines whether the payment type is displayed in the checkout.

PAYONE LIVE Mode

Here you can specify for the respective payment type whether the payments are to be processed in test mode or whether they are to be executed "live". You can also configure the test mode for individual payment types.

authorization method

  • preauthorisation The amount to be paid is reserved in the course of the order. In this case, the debit must be initiated in a second step when the goods are delivered (Capture). The receivable is only posted after the capture has been carried out.
  • authorisation - The amount tobe paid is collected immediately when the order is placed. The receivable is immediately booked on the PAYONE platform

    UI Text Box
    typenote

    Which authorization method is used for which payment method can have an effect on the cash flow. Which method you should use depends strongly on the business model and the payment type.


country

In which countries should the selected payment method be active? You can add or deselect further countries by "ctrl+click".



UI Step

Editing the orders

The PAYONE Prestashop Extension works in large parts automatically and integrates itself best possible into Prestashop.

Overview

Orders placed via the PAYONE Extension for Prestashop are listed as usual in the order overview of Prestashop. The detailed view of the order is extended by the area "PAYONE Order Management":

In this area, you can see the status of a payment and, if necessary, initiate collections or credit memos.

Capture

If "Preauthorization" is set as the authorization method for a payment type, the money may still have to be withdrawn from the payment type. With such orders you see these fields in the order administration:

Here you can enter the amount to be collected and collect it by pressing "Execute". It may take a few minutes until the capture is acknowledged via transactionstatus. The transaction overview in the backend is then updated and displays the current status of the transaction.

For orders where the authorization method "Authorization" was used, the cash flow (if possible) is initiated immediately.

Refund

If you want to refund an incoming payment, you can use the "Debit" function:

The amount entered is then posted back to the payment type used by the end customer.

UI Text Box
typeinfo

The function is only available if money has already arrived.



UI Step

Extended configurations

Here you will find separate setting options that allow you to customize our plugin more precisely to your needs.

UI Expand
titleTransaction Status Forwarding

Transaction Status Forwarding

Here you can enter (if necessary) forwarding addresses to which transaction status messages of the PAYONE platform should be forwarded from the shop. If you only use the shop to process orders, you do not need this function.

UI Text Box
typenote

A description of the status messages can be found here.



UI Expand
titleTransaction Status Mapping

Transaction Status Mapping

In the lower part of the settings you have the possibility to define for each payment type which status an order should accept as soon as a corresponding transaction status arrives from the PAYONE platform.


UI Expand
titleSend articlelist

Send articlelist

  • Under the item other you find:

Field

Description

Send article list

determines whether a list of purchase order items is to be sent to the payment provider.

UI Text Box
typenote

This setting is mandatory when using the payment method "PAYONE Safe Invoice".




UI Expand
titleChange the Order of Payment Methods

Change the Order of Payment Methods

Prestashop doesn't have a convenient way of re-ordering the payment methods in your checkout, but you can quite easily reorder the array of payment methods in our code.

Please find the following codeline in your shop:
https://github.com/PAYONE-GmbH/prestashop-17/blob/master/vendor/Payment/Payment.php#L36

Code Block
languagephp
protected static $aPaymentMethodBaseNames = array(
        'AdvancePayment',
        'CashOnDelivery',
        'CreditCard',
        'Debit',
        'Invoice',
        'BSInvoice',
        'Wallet',
        'OnlineTransfer',
    );

The order of the items in this array defines the order of payment methods in your checkout.




Quick Facts

Integrationquickfacts
TXURLmodules/fcpayone/status.php?id_shop=1
Repohttps://github.com/PAYONE-GmbH/prestashop-17/releases
Version2.0.08
SHOPID9
Systemprestashop

Table of Contents

Table of Contents
maxLevel3
include.*Requirements|Plugin Installation|PAYONE - Portal configuration|Shopware 6 - Admin configuration|Special adjustments|Editing the orders|Payment methods setup|Capture|Refund|Partialcapture and -refund|Extended configurations|Integration Quick Facts|Quick Facts|
outlinetrue
indent2em