Page tree
Skip to end of metadata
Go to start of metadata

General information

The current version of the PAYONE Payment Extension for Prestashop enables Prestashop to be connected to the PAYONE platform for the secure and automated handling of all payment processes.
The extension fits seamlessly into the existing checkout process of the Prestashop shop.
In the Prestashop administration area, extensive configuration and administration options are available. All functions of the extension can be configured individually and according to requirements.
The PAYONE Payment-Extension is constantly being further developed and is available free of charge to interested dealers for download on Github or in the Prestashop-Store.


You can always find the current extension in the Prestashop marketplace.
Alternatively you can download the latest version from our Github repository:

Then 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!
The module then appears in the "Selection" tab in the module administration of the shop for installation.

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

Configuration in the PAYONE Merchant Interface

Transactionstatus URL

In order for Prestashop to recognize the status of a payment, it is important that you enter the appropriate "TransactionStatus URL" in the PMI (PAYONE Merchant Interface). You will find the corresponding field under
Configuration > Payment Portals > IHR_PORTAL > Advanced > TransactionStatus URL The status URL follows the following scheme:

Transactionstatus URL

Please pay attention to the correct protocol that your system environment/hoster can process.

  • http
  • https


Settings Tab

Connection Setting

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




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

PAYONE Live Mode

Determines globally whether transactions are to be transferred in LIVE or TEST mode.

PAYONE Merchant ID

Your Merchant ID


The Portal ID

PAYONE Sub-Account ID

A Sub-Account ID

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

Transaction Status Forwardings

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.




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

Recurring Configurations

You can make these configurations for each payment type:




Determines whether the payment type is displayed in the checkout.


Determines for this payment type whether transactions are to be transferred in LIVE or TEST mode.

authorization method

Indicates whether the payment type is addressed by "authorization" or "preauthorization".

  • Authorization - Here the payment method is debited directly when ordering (where possible) and a claim is written on the PAYONE platform.
  • Preauthorization - As far as possible, payment will be reserved at the time of order. The payment has to be collected later in the order (see chapter "Orders").

    Please note
    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.


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

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.

A description of the status messages can be found here.

Credit Card Settings Tab

These settings are specific to credit card payment types.

General information



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!

Ensuring Maximum Conversion With 3D Secure 2.0

Starting in mid-September 2019 Issuers demand more data during payment requests for more granular risk management and better fraud protection. While you can find more information here, you can make these configuration changes to ensure maximum conversion and frictionless credit card payments for your customers:

Make sure 3D-Secure is active in your Merchant Backend

Submit cart items for credit card transactions

Request the following info during checkout (on by default)

  • phone number
  • shipping address
  • complete billing address

Tab "Setting payment methods (general)".

These settings are specific to the general payment types.

Bank collection/debit memo



also display account number/bank code number

Determines whether fields for account number and bank sort code are to be displayed in addition to the IBAN.

Display BIC field

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

Helpful for orders with accounts outside the DACH area.

Tab "E-Wallet"

These settings are specific to the wallet payment types.

PayPal Express



PayPal Express Button Image

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

Tab "Online bank transfer settings".




Display IBAN/BIC fields

determines whether fields for account number and bank sort code are to be displayed in addition to the IBAN.
If these are not displayed, the account details provided by the customer to Klarna/Sofort are saved.


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


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.

Workflow for Preauthorization and Capture Orders

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.

Workflow for orders by authorization

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

Credit Notes

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.

How to Change the Order of Payment Methods in the Checkout

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:

protected static $aPaymentMethodBaseNames = array(

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

Information and Support

Do you have any bugs or suggestions to improve the code of the extension? Open an issue in our Github repo story:
If you have any questions regarding the installation or use of the PAYONE Extension, please contact our Technical Support at the following contact details:



+49 431 259 68-500

Merchant Service

for billing and contract issues



+49 431 259 68-200

Quick Facts

PrestaShop is an efficient and innovative e-commerce solution with all the features you need to create an online store and grow your business.

Find our plugin documentation here .

Download our plugin from here .

Credit Cards



American Express


Diners Club

Maestro International




Wire Transfer

SEPA Direct Debit



Cash On Delivery

Online Bank Transfers







PAYONE Safe Invoice




Open Source

Transactionstatus URL:


 Click here for release details

Release Notes

New Features

  • add paymentmethod BSPAYONE secure invoice


  • so many bugfixes


  • compatibility with Presta 1.7.x


  • No labels