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

General Information

The PAYONE Payment-Extension for Magento enables the connection of Magento version 1.4.1 and higher to the PAYONE platform for secure and automated handling of all payment processes.
The extension supports over 20 national and international payment methods and offers integrated risk management services to minimize the risk of non-payment. The payment type portfolio can be dynamically controlled depending on the creditworthiness of the respective buyer.

The extension fits seamlessly into the existing checkout process of the Magento shop. In the Magento 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 developed in close cooperation with the agency Fatchip GmbH and can be downloaded free of charge by interested merchants.
The extension is constantly being further developed.

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 Visa

MasterCard SecureCode

American Express SafeKey

GiropaySofortEPSiDEALPostFinancePrzelewy24

SEPAPrepaymentInvoiceCash on Delivery

PayPalPaydirektAmazon PayMasterPassAlipay

PAYONE Secure InvoiceKlarnaRatePayPaysafe Pay Later

Barzahlen

Risk Management

The following risk management services are supported by the extension:

Address Check Basic (20 countries [1] )

  • Check of the billing address for existence including address correction
  • Check of the delivery address for existence including address correction

Address Check Person (Germany only)

  • Checking the billing address for the existence of the address and for postal deliverability (name, address) including address correction
  • Checking the delivery address for the existence of the address and for postal deliverability (name, address) including address correction

POS Blocking File (Direct Debit Germany)

  • Checking of account connections against blocking files from stationary trading

Credit Assessment (Germany)

  • infoscore (hard characteristics only)
  • infoscore (all characteristics)
  • infoscore (all features incl. boni score)
  • Boniversum Address validation, identification (Premium) (address validation and identification)
  • Boniversum VERITA Premium Ident S incl. address validation, identification (premium) and special addresses (address validation, identification, score value, special address)
In order to use the aforementioned risk management services, the Protect module of the PAYONE platform must be commissioned.
The plausibility and validity check of bank account connections (bank account check) and credit card numbers using LUHN checks (credit card check) is used for processing payments by direct debit and credit card regardless of the functionalities of the Protect module.
In addition, additional risk management services can be used to prevent fraud via the PAYONE platform (IP Check, BIN Check, Velocity Check, Risk Matrix, etc.).

Credit Rating-Dependent Control of the Payment Type Portfolio

The PAYONE Extension for Magento allows you to control which payment methods are offered to your buyers, depending on their creditworthiness. The check takes place in real time for each individual buyer during the checkout process. The settings can be defined differently for each payment type so that the risk checks are only carried out under certain conditions and a payment type is only offered under certain conditions.

Integration in Checkout and Connection Types (Interfaces)

The payment extension fits seamlessly into the existing checkout process of the Magento shop. The communication and data transfer takes place in the background - not visible to the buyer - between the module and the server API of the PAYONE platform. With the credit card payment method, data is transferred during the checkout process for the verification and secure storage of card data at PAYONE via the Client API of the PAYONE platform.
Feedback on the status of the transactions processed is provided via the transaction status of the PAYONE platform, which is processed by the extension to synchronise orders in the Magento shop with the current status.

Logging

All communication with the PAYONE platform is logged and can be viewed in the administration area of the Magento shop for support, testing and debugging purposes:

  • risk management services
  • payment processing
  • transaction status

An exception to this are requests sent via the Client API. This only applies to credit card verification during the checkout process.

Configuration and Administration Options of the Extension

The extension provides a new menu item PAYONE in the Magento administration area of your Magento shop. All configuration and management options as well as protocols and information are centrally located in this directory.

Download and Installation

Compatibility and Requirements

Magento Shop:

  • Edition: Enterprise, Professional or Community Edition
  • Versions: from 1.8.0.0 (older versions may work, we strongly recommend using the 1.9.x.y version series)
  • at least PHP 5.6 (though you should seriously use a more up-to-date version! https://www.php.net/supported-versions.php)

PAYONE Merchant Account:

  • PAYONE Merchant Account
  • Interface: Server API
  • Interface: Client API (if credit or debit cards are to be processed)
  • Payment methods as required
  • Optional: Module Protect
  • Optional: Further PAYONE Plattform modules (Accounting, Invoicing, Collect, Contract, Billing)

If you do not yet have a PAYONE Merchant account, please contact us. Upon request, we will gladly provide you with a test account.

Installation Steps

Installation via Github/modman (recommended)

We recommend installing the latest release from our Github Repository.  The tool modman can also be used for this purpose.

Installation via Magento Connect

The extension can also be installed via Magento Connect. However, updates are provided less frequently there, so we do not recommend this method of installation.

Download

  1. Go to the PAYONE Payment-Extension page at Magento-Connect. https://marketplace.magento.com/payone-mage-payone.html
  2. After agreeing to the license agreements, select the URL offered there and copy it to the clipboard.

Installation with the Magento Connect Manager

  1. In the administration area of your Magento shop, select System > Magento Connect > Magento Connect Manager.
  2. Insert the previously selected URL and follow the installation process.
  3. Return to the administration area. You will be prompted to activate the PAYONE Payment Extension. Click on "Activate the PAYONE Payment Extension" and follow the instructions on the page.
  4. After returning to the administration area, update all Magento caches under System> Cache Management. Log off from the administration area.
  5. Log in to the Magento backend with your access data. The PAYONE menu is now available.

Configuration in the PAYONE Merchant Interface

Transactionstatus URL

To send the transaction status to the correct address, the following must be entered in the PAYONE Merchant Interface (PMI).
Configuration > Payment Portals > YOUR_PORTAL > Advanced > TransactionsStatus URL

https:// >YOUR_SHOP< /index.php/payone_core/transactionStatus


Configuration

General Configuration

Setting up the Cronjob for Payment Status Processing

In order to be able to process the payment status that the PAYONE platform sends to the Magento shop, it is mandatory to set up a cronjob.
Detailed information about this can be found in the Magento Wiki: http://www.magentocommerce.com/wiki/1_-_installation_and_configuration/how_to_setup_a_cron_job

Configuration of State Codes for International Shops

A standard version of Magento 1 does not install itself with the federal state codes from e.g. Japan or Indonesia. As a result, a free text field is displayed in the checkout by default for such countries. However, the PAYONE API expects the abbreviations for states according to ISO 3166-2. These must then be added to the table of Shop System > directory_country_region.

sample query
insert into directory_country_region (`country_id`,`code`,`default_name`) values ('JP','JP-05','Akita')

A complete reference of the codes for the states can be found here in the Server API documentation.

State information is required in the following countries: US, CA, MX, AR, BR, CN, ID, IN, JP and TH.

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 3-D Secure is active in your Merchant Backend

Turn on IP collection during checkout under "Configuration" → PAYONE → General

Submit cart items for credit card orders

Request the following info during checkout (on by default)

  • phone number
  • shipping address
  • complete billing address

Configuration Wizard

PAYONE Menu > Configuration Wizard

Step 1: Configuration Area


In step 1, select the configuration area for which you want to perform the configuration with the configuration wizard. Then click Next.

Step 2: Global Settings 


 

Field

Description

Merchant ID

The customer number assigned by PAYONE.

portal ID

The ID of the payment portal via which the shop sends its requests to the PAYONE platform.

sub account ID

The ID of the sub-account you created in the PMI, which is used to process the transactions.

security key

The key you assign in the PMI to encrypt requests to the PAYONE platform.

Payment from permitted countries

Selection option for the shop in which countries payment via PAYONE is to be made possible.

authorization method

  • Pre-authorization
    Whenselecting "Pre-authorization", the amount to be paid is reserved in the course of the order. In this case, the debit must be initiated in a second step when the goods are delivered (Capture). The receivable is only posted after the capture has been carried out.
  • Authorization
    When"Authorization" is selected, the amount to be paid is collected immediately when the order is placed. The receivable is posted immediately.

Note: With the online transfer types giropay, SOFORT Überweisung, eps, PostFinance and iDEAL, payment is made in full even if "Preauthorization" is selected. In this case, the claim is to be booked separately by "Capture" despite this.

Transfer IP address

Select whether the IP address of the end customer should be transmitted to the PAYONE platform. Currently the PAYONE platform only supports IPv4. If your hoster supports IPv6, you should deactivate this setting, otherwise rejected transactions may occur. In this case a check of the IP address is not possible.

currency

Here you can select whether requests are sent to the PAYONE platform in the selected currency, or whether the amounts should be converted Magento internally into a base currency beforehand.

Step 3: Configure Payment Methods

 
In this overview you can see all payment methods configured so far. You can add further payment methods using the blue buttons. Via the Edit links in the right column, already configured payment methods can be edited.

Add Payment Type

Field

Description

Activated

Select Yes / No if the payment method is activated.

order

Enter an integer that determines where in the checkout the payment method is offered to the customer.

name

Free text entry for the name of the payment method as it is displayed to the customer in the checkout.

handling charge

Determination of a handling fee per shipping method and associated countries.

Minimum value of goods

The minimum value of goods from which the payment type is displayed to the customer in the checkout.

Maximum value of goods

The maximum value of goods up to which the payment method is displayed to the customer in the checkout.

operating mode

Choice between Test / Live. This determines whether the PAYONE platform is addressed in Test or Live mode.

Use Global Settings

Select Yes / No. If No is selected, all parameters from the global settings can be configured individually for this payment method. The documentation of these settings can be found under point 4.2.2.

Edit Payment Type


When editing a payment type, you can adjust the previously configured values or delete the entire payment type.

Step 4: Address Validation

Field

Description

Activated

Selection Yes / No. Depending on the selection, the address check is carried out according to the settings.

Check billing address

Selection None / Basic / Person. Depending on the selection, the address is checked in the appropriate granularity.

Check delivery address

Selection None / Basic / Person. Depending on the selection, the address is checked in the appropriate granularity.

operating mode

Choice between Test / Live. This determines whether the PAYONE platform is addressed in Test or Live mode.

Confirming the address correction

Select Yes / No. This determines whether the buyer will be asked to confirm the correction when returning a corrected address.

Minimum value of goods

The minimum value of goods from which an address check is carried out.

Maximum value of goods

The maximum value of goods up to which an address check is carried out.

person status mapping

When the address check is executed at person level, a traffic light value can be assigned for payment type selection, depending on the result of the person check.

Invalid data message

Free text field for entering the message that is displayed to the buyer in the checkout if he has not entered valid data.

error handling

Cancel selection of order / Continue order process. This determines whether the order process should still be carried out in the event of technical problems or missing entries.

validity

Enter an integer that determines how long the result of the address check is to be kept. No new check is carried out within this period.

Step 5: Creditrating


Field

Description

Activated

Select Yes / No. Determines whether the credit check is activated with the following settings.

Time of examination

Selection of Before payment method selection / After payment method selection. Determines the time of the test. Only the selection According to payment method selection is Trusted Shops compliant and the following italicized fields are additionally displayed.

Activated for the following payment types

Multiple selection of payment types that result in a credit check when selected.

Note text activated

Select Yes / No. Determines whether a text message is displayed to the buyer.

hint text

Free text field for specifying the note text.

customer approval

Select Yes / No. Determines whether the buyer is asked to perform a credit check. If the customer does not agree, an order is still possible.

Text of the consent query

Free text field for the approval query. Only displayed if customer approval is set to Yes.

Creditworthiness check type

Selection of whether hard/soft criteria and the boniscore value should be queried.

Permitted payment types for traffic light value "YELLOW

Multiple selection of the permitted payment types when the traffic light value YELLOW is returned.

Permitted payment types for traffic light value "RED".

Multiple selection of the permitted payment types when the traffic light value RED is returned.

Activate A/B test mode

Select Yes / No. Determines whether the credit assessment is to be carried out on a random basis.

Frequency of sampling

Enter an integer that defines the frequency of the creditworthiness checks performed in the sampling mode.

error handling

Cancel selection of order / Continue order process. This determines whether the order process should still be carried out in the event of technical problems or missing entries.

validity

Input of an integer that determines how long the result of the credit assessment should be kept. A buyer who reorders within this period will not be subject to any further review.

operating mode

Choice between Test / Live. This determines whether the PAYONE platform is addressed in Test or Live mode.

Minimum value of goods

The minimum value of goods from which a credit check is carried out.

Maximum value of goods

The maximum value of goods up to which a credit check is carried out. The minimum and maximum goods value are checked against the Magento internal value "Subtotal", which does not include taxes (nor VAT) or shipping costs.

Step 6: End

General Configuration


Menu PAYONE > Configuration > General

Global


Field

Description

Merchant ID

The customer number assigned by PAYONE.

portal ID

The ID of the payment portal via which the shop sends its requests to the PAYONE platform.

sub account ID

The ID of the sub-account you created in the PMI through which the transactions are processed.

security key

The key you assign in the PMI to encrypt requests to the PAYONE platform.

Payment from permitted countries

Selection option for the shop in which countries payment via PAYONE is to be made possible.

authorization method

  • Pre-authorization - When selecting "Pre-authorization", the amount to be paid is reserved in the course of the order. In this case, the debit must be initiated in a second step when the goods are delivered (Capture). The receivable is only posted after the capture has been carried out.
  • Authorization - When"Authorization" is selected, the amount to be paid is collected immediately when the order is placed. The receivable is posted immediately.

Note: With the online transfer types giropay, SOFORT Überweisung, eps, PostFinance and iDEAL, payment is made in full even if "Preauthorization" is selected. In this case, the claim is to be booked separately by "Capture" despite this.

Transfer IP address

Select whether the IP address of the end customer should be transmitted to the PAYONE platform. Currently the PAYONE platform only supports IPv4. If your hoster supports IPv6, you should deactivate this setting, otherwise rejected transactions may occur. In this case a check of the IP address is not possible.

proxy mode

Activate this option to transfer the IP from the HTTP_X_FORWARDED_FOR header. This is only necessary if your shop is running behind a proxy server.

currency

Here you can select whether requests are sent to the PAYONE platform in the selected currency, or whether the amounts should be converted Magento internally into a base currency beforehand.

Send Invoice Information

Field

Description

Activate PDF download

Select Yes / No. Activates the download of PDF files created via the PAYONE platform. To be able to use this function, you must have ordered the Invoicing module.

Transfer invoice information

Select Yes / No. This option activates the transmission of article data in order to create an invoice on the PAYONE platform.

Dynamic text on the invoice

Free text entry for a dynamic text on the invoice. The maximum length is 255 characters and various Magento variables can be used as placeholders.

Dynamic text on the credit memo

Free text entry for a dynamic text on the credit memo. The maximum length is 255 characters and various Magento variables can be used as placeholders.

Status Mapping


In this mask the different transaction statuses of the PAYONE platform can be mapped to Magento order status. If a new transaction status is received, the corresponding "Magento status" is set in the order overview in the Magento backend.

please notice
If you map the status "appointed" to "Payment Review", the PDF invoices will not be generated automatically. A different status should be selected here.

Credit Card Payment

The Magento 1 Extension offers you the conformity with the "lowest" Compliance Level according to PCI DSS (SAQ A). Since in this compliance level all credit card data may only be entered in fields hosted by a PCI DSS certified service provider, our extension uses iFrames that are integrated into the checkout. However, these do not inherit the CSS of the shop template, but contain their own style. You can use the following settings to customize these fields.


Field

Description

minimum validity period

Enter an integer in days. This value defines the number of days a credit card must be valid up to before it is rejected at checkout.

Request Type

Selection of:

  • hosted-iFrame
  • AJAX

Make sure to always use "hosted iFrame". Only merchants with a PCI DSS certification level of SAQ A-EP or greater are allowed to use AJAX. We still strogly suggest using hosted iFrame!

For more information on this matter please refer to this page.

field configuration

Here you can set separate parameters for the individual fields of the credit card query.

type

Selection of:

  • Numeric - Only numbers are allowed and for mobile devices the numeric keyboard is used input type="tel".
  • Password - input type="password"
  • Text - input type="text"

Number of characters

Length of the field in characters ( HTML attribute size )

Max character

Maximum length of input ( HTML attribute maxlength )

iFrame

Selection of:

  • Standard - Uses width and height from standard style
  • Custom - Uses width and height from the following fields

width

CSS - Specify width

height

CSS - Indication of height

style

  • Standard - Uses CSS specification from Standard
  • Custom - Uses CSS specification from the following field

CSS

Specification of CSS properties for field
Deactivated with previous selection of Standard

Standard Style

 

fields

  • Input - CSS specification for all input fields (HTML input)
  • Selection - CSS specification for all selection fields (HTML select )

iFrame

  • Width - CSS specification
  • Height - CSS specification

Error Output

 

active

Selection of:

  • Yes
  • No

Language

Select the language in which the error message should be returned.

Activate automatic recognition of credit card number

determines whether the card number should be determined automatically when the first six digits are entered.

PayPal ECS

Field

Description

PayPal Express Checkout Shortcut on Shopping Cart

Activates the PayPal ECS button in the shopping cart for checkout

Paypal Express Image Button

Here you can upload the corresponding logo for the StoreView.

In order to use PayPal ECS correctly, it is necessary to have activated the module included in the Magento standard for PayPal.

Payment Methods


Menu: PAYONE > Configuration > Payment methods

Overview


All PAYONE payment types created are displayed in this overview. Using the buttons at the top you can add and configure further payment methods. The Edit link can be used to configure each individual payment type specifically. Please note that you should only configure the payment methods that you have ordered from PAYONE.

Add Payment Method

Field

Description

Activated

Select Yes / No if the payment method is activated.

order

Enter an integer that determines where in the checkout the payment method is offered to the customer.

name

Free text entry for the name of the payment method as it is displayed to the customer in the checkout.

handling charge

Determination of a handling fee per shipping method and associated countries.

Minimum value of goods

The minimum value of goods from which the payment type is displayed to the customer in the checkout.

Maximum value of goods

The maximum value of goods up to which the payment method is displayed to the customer in the checkout.

booking text

Free text input for the information that appears subsequently on the buyer's settlement. (e.g. purpose of use for SEPA direct debits)

operating mode

Choice between Test / Live. This determines whether the PAYONE platform is addressed in Test or Live mode.

Use Global Settings

Select Yes / No. If No is selected, all parameters from the global settings can be configured individually for this payment method. The documentation of these settings can be found here.

Edit Payment Method

Field

Description

Activated

Select Yes / No if the payment method is activated.

order

Enter an integer that determines where in the checkout the payment method is offered to the customer.

name

Free text entry for the name of the payment method as it is displayed to the customer in the checkout.

handling charge

Determination of a handling fee per shipping method and associated countries.

Minimum value of goods

The minimum value of goods from which the payment type is displayed to the customer in the checkout.

Maximum value of goods

The maximum value of goods up to which the payment method is displayed to the customer in the checkout. Please note that here, in contrast to the configuration of the credit check, the Magento internal value "BaseGrandTotal" (i.e. the completely invoiced amount including VAT and shipping costs) is used as a basis.

operating mode

Choice between Test / Live. This determines whether the PAYONE platform is addressed in Test or Live mode.

Use Global Settings

Select Yes / No. If No is selected, all parameters from the global settings can be configured individually for this payment method. The documentation of these settings can be found under point 4.3.1.

Payment Type-Specific Settings

The following describes the configuration options that are specific to a payment type. Only those fields are explained that differ from the above configuration or are new.

Credit Card


Field

Description

card type

Multiple selection. Which credit card brands should be offered in the frontend?

Hide Card Verification Number

hides the verification number for cards that do not offer it

Check card verification number

Selection of:

  • No
  • First order with card
  • Always
    Determines whether the credit card verification number is queried. This is only possible if the acquirer allows it.

Save payment data for registered users

Here you can specify whether the pseudo credit card data should be saved for registered users so that the user does not have to enter his credit card number again when ordering again. The actual credit card data is only stored with PAYONE.

SEPA Basic Direct Debit Scheme


Field

Description

Check bank details

Select Yes / No. Determines whether an additional check of the bank details is to be carried out.

Type of bank details check

Select Regular Check / Check against POS Block List. Specifies how the bank details are to be checked. There is the possibility of a check against a POS blacklist with information on open receivables from the stationary retail trade. The examination is carried out by the credit agency KUNO.

Message when bank details are blocked

This message is displayed in the checkout if the bank details check returns a negative result.

List of supported account countries

Multiple selection of the countries from which the payment type debit memo is supported. The PAYONE platform currently only supports direct debits for German bank accounts.

Display additional account number/bank code number

Select Yes / No. If Yes is selected, the fields for account number and bank sort code are displayed in addition to the input fields for IBAN and BIC. The end customer only has to specify one of the two combinations. The account number and bank code can only be entered for German bank accounts.

Save payment data for registered users

Here you can specify whether the IBAN and BIC of a logged in user should be saved so that they do not have to be entered again when a new order is placed. The account connection is stored encrypted in the Magento database.

Activate Mandate Granting

Select Yes / No. Should the SEPA mandate manager be used? A check of the bank details is obligatory. A check against the POS lock list is not possible.

Download mandate as PDF

Select Yes / No. If Yes is selected, a link is offered after the order has been placed, via which the end customer can download the SEPA Mandate as a PDF file.
Note: This product must be ordered separately.

Secure Purchase on Account (Klarna)



Field

Description

Klarna Store IDs

Specific store IDs must be configured for the Klarna payment method. You can obtain these store IDs from Klarna.
Please note that payment processing via Klarna is only possible if the billing address and delivery address are the same.

Barzahlen

To activate the payment method, we recommend that you copy the display at: https://integration.barzahlen.de/de/designanforderungen
Example:

Sample Code
<label for="payment_barzahlen">
  <img style="height: 3em; vertical-align: -1em;" src="https://cdn.barzahlen.de/images/barzahlen_logo.png" alt="Barzahlen">
</label>
<img style="float: right; margin-left: 10px; max-width: 180px; max-height: 180px;" src="https://cdn.barzahlen.de/images/barzahlen_special.png">
Mit Abschluss der Bestellung bekommen Sie einen Zahlschein angezeigt, den Sie sich ausdrucken oder auf Ihr Handy schicken lassen können. Bezahlen Sie den Online-Einkauf mit Hilfe des Zahlscheins an der Kasse einer Barzahlen-Partnerfiliale.<br/><br/>
<strong>Bezahlen Sie bei:</strong>
 
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_01.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_02.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_03.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_04.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_05.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_06.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_07.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_08.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_09.png" style="height: 1em; vertical-align: -0.1em;">
<img src="https://cdn.barzahlen.de/images/barzahlen_partner_10.png" style="height: 1em; vertical-align: -0.1em;">

Ratepay

Field

Description

Display detailed error messages

Here you can select whether, in the case of rejection, the error message transferred by RatePay should be displayed, for example, that the transaction could not be executed due to the credit check, or whether a generic error message should be displayed.

type

Multiple selection. Here you can select which payment methods offered by Ratepay should be available.

RatePay Shop IDs

RatePay requires the transfer of a so-called Shop-ID, which identifies the parameters of the shop. Enter the shop IDs received from RatePay and the corresponding currency in ISO 4217 format (e.g. EUR, USD, DKK). When saving the configuration, the parameters are queried at RatePay and transferred to the configuration.

Paysafe Pay Later



Field

Description

Company Name

The full name of the company must appear here. The name will be used in the privacy policy.

Installment purchase Sample Username

In order to retrieve the installment purchase draft contract, the user name assigned by Payolution (usually dealer name installation) must be stored here.

Installment purchase Sample Password

The password assigned by Payolution must be stored here in order to retrieve the installment purchase draft contract.

B2B Fashion

If the B2B mode is activated, it is automatically assumed that it is a B2B transaction if the "Company" field was executed during address entry. To check the creditworthiness of the company, further information such as the commercial register number is then requested in the checkout.

type

Multiple selection: Here you can select which payment methods of Payolution should be available to the buyer. You can choose between purchase on account, payment by instalments and direct debit.

Amazon Pay

Field

Description

Client ID & Seller ID

These fields contain the Client ID and Seller ID as stored by the Merchant Service on the PAYONE platform after completion of the configuration.

Watch your step!
You must first make all other settings and save the payment method Amazon Pay once before you can retrieve these values via the "Get Configuration" button!

JavaScript Origin & Return URL

The URLs in these fields are for your information. They must be deposited in the Amazon Seller Central, otherwise Amazon will reject the login requests.

Button Type, Color, Language

Here you can select the type of button, the color and the language for the Amazon Pay Button. The recommended settings are already selected as default.

Amazon Fashion

Amazon Pay supports two basic operating modes:

  • Synchronous: An attempt is made to obtain a direct (synchronous) confirmation for the Amazon Pay payment request. It may be that Amazon Pay refuses a payment request because a longer check would be necessary.
  • Asynchronous: Amazon Pay checks the payment over a longer period of time. The payment is accepted or rejected later (asynchronously).

    In the PAYONE Plugin for Magento, this results in two operating modes:
  • Always synchronous: There is always an attempt to obtain a synchronous confirmation for the Amazon Pay payment request. An asynchronous payment request does not take place.
  • Asynchronous on error: A synchronous payment request is first attempted. If this is rejected by Amazon Pay, an asynchronous payment request is attempted, which has a higher chance of success. Only if this was also rejected, the buyer will be returned accordingly.

Integration Settings in Seller Central
Please enter the following URL under Integrator-URL in the item "Integration settings" in Seller Central: https://gpc-sys.pay1.de/gpc/amazon/1.0/notify - the "Seller URL" may remain empty. This URL ensures that the shop receives all notifications from Amazon.

Also please make sure to store all your shop URLs as allowed Javascript Origin in Seller Central

Protect

Menu PAYONE > Configuration > PROTECT

Address Validation

Field

Description

Activated

Selection Yes / No. Depending on the selection, the address check is carried out according to the settings.

Check billing address

Selection None / Basic / Person. Depending on the selection, the address is checked in the appropriate granularity.

Check delivery address

Selection None / Basic / Person. Depending on the selection, the address is checked in the appropriate granularity.

Check billing address for virtual orders

Should the billing address be checked for orders without a delivery address?

Mode

Choice between Test / Live. This determines whether the PAYONE platform is addressed in Test or Live mode.

Confirming the address correction

Select Yes / No. This determines whether the buyer will be asked to confirm the correction when returning a corrected address.

Minimum value of goods

The minimum value of goods from which an address check is carried out.

Maximum value of goods

The maximum value of goods up to which an address check is carried out.

person status mapping

When the address check is executed at person level, a traffic light value can be assigned for payment type selection, depending on the result of the person check. Please refer to our Server API documentation (chapter 5) for an explanation of the specific codes.

Invalid data message

Free text field for entering the message that is displayed to the buyer in the checkout if he or she has not entered valid data.

error handling

Cancel selection of order / Continue order process. This determines whether the order process should still be carried out in the event of technical problems or missing entries.

validity

Enter an integer in days that determines how long the result of the address check is to be kept. No new check is carried out within this period.

Service provider for address checks
Various service providers are available for address and creditworthiness checks. Our support team will be happy to explain the range of services of the individual checks and which service provider is the right one for you.

Credit Assessment


Field

Description

Activated

Select Yes / No. Determines whether the credit check is activated with the following settings.

Time of examination

Selection of Before payment method selection / After payment method selection. Determines the time of the test. Only the selection of By payment method selection is Trusted Shops compliant and the following italicized fields are additionally displayed.

Activated for the following payment types

Multiple selection of payment types that result in a credit check when selected.

Note text activated

Select Yes / No. Determines whether a text message is displayed to the buyer.

hint text

Free text field for specifying the note text.

customer approval

Select Yes / No. Determines whether the buyer is asked to perform a credit check. If the customer does not agree, an order is still possible.

Text of the consent query

Free text field for the approval query. Only displayed if customer approval is set to Yes.

Creditworthiness check type

Selection of whether hard/soft criteria and the boniscore value should be queried.

Permitted payment types for traffic light value "YELLOW

Multiple selection of the permitted payment types when the traffic light value YELLOW is returned.

Permitted payment types for traffic light value "ROT".

Multiple selection of the permitted payment types when the traffic light value YELLOW is returned.

Activate A/B test mode

Select Yes / No. Determines whether the credit assessment is to be carried out on a random basis.

Frequency of sampling

Enter an integer that defines the frequency of the creditworthiness checks performed in the sampling mode.

error handling

Cancel selection of order / Continue order process. This determines whether the order process should still be carried out in the event of technical problems or missing entries.

validity

Enter an integer that determines how long the result of the credit check is to be kept. A buyer who reorders within this period will not be subject to any further review.

operating mode

Choice between Test / Live. This determines whether the PAYONE platform is addressed in Test or Live mode.

Minimum value of goods

The minimum value of goods from which a credit check is carried out.

Maximum value of goods

The maximum value of goods up to which a credit check is carried out. The minimum and maximum goods value are checked against the Magento internal value "Subtotal", which does not include taxes (nor VAT) or shipping costs.

Miscellaneous


Menu PAYONE > Configuration > Misc

Processing the Transaction Status

Field

Description

cron expression

Value for the Linux service CRON, which determines the intervals at which the transaction status is processed.

Valid PAYONE IPs

List of valid PAYONE IP addresses that may deliver a transaction status.

proxy mode

Enable this option for IP validation with HTTP_X_FORWARDED_FOR. This is only necessary if your shop is running behind a proxy server.

Logging active

Cronjob progress in transaction status processing is logged in /var/log/payone_cron.log.

Forwarding the Transaction Status


Field

Description

forwarding

At this point you can define which status is forwarded to which URL and how long the timeout is in seconds until the redirection attempt is terminated.

Invoice Information - Discount

Field

Description

item number

Here you can define the article number, how it should be transferred to PAYONE. If you do not require special treatment, leave the fields blank.

designation

Here you can enter a value as for the article number, which then corresponds to the description of the article.

Invoice Information - Shipping Costs

Field

Description

item number

Here you can define the article number, how it should be transferred to PAYONE. If you do not require special treatment, leave the fields blank.

Invoice Information - Credit Memo

Field

Description

Correction refund - Article number

Here you can define the article number for the correction reimbursement as it is to be transferred to PAYONE. If you do not require special treatment, leave the field blank.

Correction refund - Description

Here you can define the description for the correction reimbursement as it is to be transferred to PAYONE. If you do not require special treatment, leave the field blank.

Correction surcharge - Article number

Here you can define the article number for the correction surcharge as it is to be transferred to PAYONE. If you do not require special treatment, leave the field blank.

Correction surcharge - Description

Here you can define the description for the correction surcharge as it is to be transferred to PAYONE. If you do not require special treatment, leave the field blank.

Configuration e-mail in Case of Errors

Field

Description

Activated

Activates the mail reporting in case of error messages that arise in relation to the extension.

consignor

Here you can select who is the sender of the error mails. The contacts are taken from the Magento function of the addresses.

receivers

Here you can select who is the recipient of the error mails. The contacts are taken from the Magento function of the addresses.

Copy to

Here you can select who is the additional recipient of the error mails. The contacts are taken from the Magento function of the addresses.

submission

Here you can select the template used to create the e-mail. However, you should always use the PAYONE e-mail error template.

E-mail Configuration AVS


The Address Verification System (AVS) is a American Express address verification system. The billing address entered by the end customer is compared with the billing address of the credit card.

Field

Description of the

Activated

Enables / disables the sending of mail, for AVS conditional information.

Send e-mail for AVS value

Multiple drive selection of values that can be returned by the AVS system.

consignor

Here you can select who is the sender of AVS mails. The contacts are taken from the Magento function of the addresses.

receivers

Here you can select who the recipient of AVS mails is. The contacts are taken from the Magento function of the addresses.

Copy to

Here you can select who is the additional recipient of AVS mails. The contacts are taken from the Magento function of the addresses.

submission

Here you can select the template used to create the e-mail. However, you should always use the PAYONE Email AVS template.

Export Configuration


Menu PAYONE > Configuration > Export configuration
A click on Export configuration opens a download request of your browser.

You can now open this file with an XML editor and view or save it. This export is very important for every support request to the PAYONE team in order to avoid possible configuration problems. This file can also be used to determine whether any further extensions have been installed that could cause compatibility problems.

Orders


PAYONE menu > Orders

Overview

 
Here you will find a PAYONE-specific order overview similar to the Magento order overview. In addition to the standard information, you can view at a glance the payment status on the PAYONE platform, the exact type of payment (e.g. credit card brands) and, if applicable, the dunning status. A click on View opens the detailed view of the corresponding order.


Details

On the detail page, you can view details on the current status of the payment. Furthermore, invoices can be created, captures can be booked and credit notes can be created using the buttons at the top.

Transactions


PAYONE Menu > Transactions

Overview


Here you will find an overview of all transactions processed via PAYONE. By clicking on View, you can view details of the relevant transaction. You also have the option of filtering by payment type, status or amount, for example.


Details

Here you will find all parameters of a specific transaction via the PAYONE platform. In addition to transaction and order numbers, the payment method, currency and status are also displayed. This view is also useful for troubleshooting, as the reason for a failed transaction is also displayed.

Logs

Under the menu item Logs you will find all information about processed payments and communication with the PAYONE platform.

Transactionstatus


Menu PAYONE > Logs > Transaction status

Overview


The Transactions submenu item displays Magento received transaction status notifications for each order and transaction. These notifications are sent from the PAYONE platform to your shop. If there are any errors, you can find out here whether the transaction status was received correctly and what the current status is for a transaction. By clicking on View, you can display details on a transaction status.

Details


On the details page, you will see all the transaction status information transmitted through the PAYONE platform to your shop. Thus, you can always track which data your Magento shop has received and processed.
A detailed explanation of the respective parameters can be found in the technical documentation of the PAYONE platform in the PAYONE Merchant Interface (PMI) under Downloads > Documentation.

API


Menu PAYONE > Logs > API

Overview


In this overview you will find all requests from the Magento shop to the PAYONE platform as well as the answers of the PAYONE platform to these requests. Only the requests that were transmitted to the PAYONE platform via Client API are not listed in this overview. This applies to credit card information that is transferred directly from the buyer's browser to the PAYONE platform using Ajax technology so that your shop does not come into contact with sensitive credit card information. By clicking on View, you can display an API request in detail.

Details


In the left column you can see the request that the Magento shop has sent to the PAYONE platform. On the right you will find the answer. A detailed explanation of the respective parameters can be found in the technical documentation of the PAYONE platform in the PAYONE Merchant Interface (PMI) under Downloads > Documentation.

Information and Support

Do you have any bugs or suggestions to improve the code of the extension? Open an issue in our Github repository: 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: https://www.bspayone.com/DE/en/contact-germany (Technical service line (E-Commerce))


Quick Facts

Download

Transactionstatus URL:

<SHOPURL>/index.php/payone_core/transactionStatus

LATEST RELEASE     v4.5.0
 Click here for release details

New Features

  • We split Ratepay Invoice and Ratepay Installments into separate payment methods
  • New responsive Installment Calculator for Ratepay
  • Customers can now decide themselves in which way they want to pay their Ratepay Installments

Bugfixes

  • This is a big one: Introduce cache bypass to fix issues with invalid store configs (this should help with "Payment method configuration with id "0" not found")

Maintenance

  • Tidied up payment method selection in backend
  • Licensemanager is now completely gone. ⚰

Table of Contents


  • No labels