Skip to end of metadata
Go to start of metadata


Requirements

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

Plugin Installation

You can download the latest version from our Github repository:

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!

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

<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".

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

Detailed 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:

Creditcard

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.

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

PAYONE 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.

Helpful for orders with accounts outside the DACH area.

PayPal 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.

Sofort

Sofort

Field

Description

Display IBAN/BIC fields

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

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

    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".

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.

The function is only available if money has already arrived.

Extended configurations

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

Transaction 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.

A description of the status messages can be found here.

Transaction 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.

Send 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.

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

Change 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

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

Payment methods + Features

Find our plugin documentation here .

Download our plugin from here .

Credit Cards

Visa

Mastercard

American Express

JCB

Diners Club

Maestro International

Wallets

paydirekt

PayPal

Wire Transfer

Cash On Delivery

PAYONE Direct Debit

PAYONE Invoice

PAYONE Prepayment

Online Bank Transfers

EPS

Giropay

iDEAL

PostFinance Card

Sofort

Financing

PAYONE Secure Invoice

Cash

Barzahlen

General

Open Source

Transactionstatus URL:

<SHOPURL>/modules/fcpayone/status.php?id_shop=1

Latest Release

v2.0.0

Release Notes

New Features

  • add paymentmethod BSPAYONE secure invoice

Bugfixes

  • so many bugfixes

Maintenance

  • compatibility with Presta 1.7.x

Download

Table of Contents



  • No labels