- Created by PAYONE Admin, last modified on 2022-06-08
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
Field | Description |
---|---|
active |
|
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 Key | Please 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
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
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
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
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 |
|
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
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
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
- 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
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
Visa
Mastercard
American Express
JCB
Diners Club
Maestro International
paydirekt
PayPal
Cash On Delivery
PAYONE Direct Debit
PAYONE Invoice
PAYONE Prepayment
EPS
Giropay
iDEAL
PostFinance Card
Sofort
PAYONE Secure Invoice
Barzahlen
Open Source
Transactionstatus URL:
<SHOPURL>/modules/fcpayone/status.php?id_shop=1
Latest Release
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