- This line was added.
- This line was removed.
- Formatting was changed.
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.
Supported payment methods
The extension supports the processing of the following payment methods via the PAYONE platform.
|title||credit and debit cards|
|UI Text Box|
|Information: Depending on the respective acceptance contract, other payment methods such as Visa Electron, Visa Debit and other cards can also be processed via the aforementioned payment methods. Please contact us if you need further information.|
|title||Online Bank Transfer|
|title||Secured Payment Methods (factoring)|
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
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:
|UI Text Box|
Please pay attention to the correct protocol that your system environment/hoster can process.
You can configure the basic configuration of the module in the Settings tab → Connection settings
PAYONE Live Mode
Determines globally whether transactions are to be transferred in LIVE or TEST mode.
PAYONE Merchant ID
Your Merchant ID
PAYONE Portal 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.
You can make these configurations for each payment type:
Determines whether the payment type is displayed in the checkout.
PAYONE LIVE Mode
Determines for this payment type whether transactions are to be transferred in LIVE or TEST mode.
Indicates whether the payment type is addressed by "authorization" or "preauthorization".
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.
|UI Text Box|
A description of the status messages can be found here.
Credit Card Settings Tab
These settings are specific to credit card payment types.
Determines whether the card CVC Code (CVC, CVV) is queried during checkout.
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:
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.
These settings are specific to the wallet payment types.
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.
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.
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|
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( '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.
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: https://github.com/payone-gmbh
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
for billing and contract issues
+49 431 259 68-200
|Table of Contents|