The current version of the PAYONE Payment Extension for Prestashop enables Prestashop to be connected to the BS 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 BS 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.
Further information can be found at https://www.bspayone.com.
Supported payment methods
The extension supports the processing of the following payment methods via the PAYONE platform.
|Visa||Mastercard||Maestro||American Express||JCB||Diners Club||Discover|
|Verified by Visa||MasterCard SecureCode||American Express SafeKey|
|PAYONE Secure Invoice|
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:
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 BS 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".
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 BS 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.
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.
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 BS PAYONE Prestashop Extension works in large parts automatically and integrates itself best possible into Prestashop.
Orders placed via the BS 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.
The function is only available if money has already arrived.
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 BS PAYONE Extension, please contact our Technical Support at the following contact details:
- No labels