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

Functional Description

Supported payment methods

The extension supports the processing of the following payment methods via the PAYONE platform.

VisaMastercardMaestroAmerican ExpressJCBDiners ClubDiscover

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.
Verified by VisaMasterCard SecureCodeAmerican Express SafeKey

GiropaySofortEPSiDEALPostFinance

SEPAPrepaymentInvoice

PayPalPaydirekt

PAYONE Secure Invoice


Installation

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
http(s)://shopurl/modules/fcpayone/status.php?id_shop=1

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

  • http
  • https

Configuration

Settings Tab

Connection Setting

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


Field

Description

active

  • yes - activates the BS 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

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.

Other

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

Recurring Configurations

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

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

country

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.

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!

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



Field

Description

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



Field

Description

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

SOFORT

Field

Description

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.

Orders

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

Overview

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.

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.

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:

email

tech.support@bspayone.com

Phone

+49 431 259 68-500

Merchant Service

for billing and contract issues

email

merchantservice@bspayone.com

Phone

+49 431 259 68-200

Quick Facts

Download

Transactionstatus URL:

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

LATEST RELEASE     v2.0.0
 Click here for release details

Release Notes

New Features

  • add paymentmethod BSPAYONE secure invoice

Bugfixes

  • so many bugfixes

Maintenance

  • compatibility with Presta 1.7.x

  • No labels