Requirements

An active PAYONE - Account is required. If you do not have one yet, please contact us.

Plugin Installation

You have 2 ways to install our plugin:

composer require payone-gmbh/oxid-6

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/fc/fcpayone/status.php 

Additional Response-data

Under General, set the Additional Response data for both Live and Test modes to "on".

Oxid - Admin configuration

• Activate the module in the Oxid backend.

Payment methods setup

• In the menu item Configuration → Payment methods both the standard payment methods of your OXID eShop and the payment methods available via PAYONE are displayed. Here you can configure the desired payment methods.

• The PAYONE payment types are an extension of the OXID standard payment types and offer additional options.
  To display only the PAYONE payment types, use the filter function PAYONE Only in the header of the payment type table.

Overview

The overview shows you all PAYONE payment methods that are available for configuration. Please only configure the payment methods that have been activated for your merchant account.

Special adjustments

Some payment methods require special adjustments. The next points are only relevant to you if you use the specific payment method:

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

UI Expand
title Amazon Pay
Amazon Pay Field Description Example Amazon Seller ID Displays the current Seller ID Amazon Client ID Displays the current Client ID Retrieve configuration from PAYONE click this button to retrieve the current configuration from PAYONE. UI Text Box type warning This payment method won't work before the configuration has been saved! Amazon Button Type Amazon Pay (standard)  Pay (slightly smaller) Amazon Pay (super small) Amazon Button Color Gold Light grey Dark grey   Amazon Mode Always Synchronous Asynchronous on failure - can have better conversion rate, but can complicate your workflow Login method Automatic - recommended setup Popup - only works for SSL-secured Shops Redirect UI Text Box 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. From the Seller Central home page, select “Integration - Integration Central” from the navigation bar on top-left side From Integration Central page, scroll down to the “Manage client ID/store ID(s)” section, and click “View client ID/store ID(s)” If you have an existing client or Store ID registered, review the configuration of the selected store. You can click on the “Edit” link on the right side to edit informatio If you click on the “Edit” button, you can edit all the details of the client configuration From STEP 3, if you click on the “Create new configuration” link on top, you will be able to create a new client configuration providing all the relevant information Additionally, the Allowed Return URL has to be set to <shoproot>/index.php?cl=user&fnc=fcpoamazonloginreturn

Please enter the key here to protect the data communication against manipulation. This must be identical to the key stored in the associated payment portal for Secure Invoice.

+ PAYONE Secured Installment

These two payment methods require their own payment portal. Please enter under Customers → Payments → PAYONE → Konfiguration → applies to payment method: PAYONE Secured Invoice bzw. PAYONE Secured Installment a separate portal ID.

Paydirekt

Field	Description
Paydirekt-Express button	At this point you can choose which design of the Paydirekt-Express-Button you want to use in the checkout. The following buttons are available for selection: Green Green 2 White White 2
Webaddress shipping terms	Entering a webaddress for your Shipping Terms is mandatory for usage of the Paydirekt Express payment method.
Deliveryset	Please choose the matching deliveryset for your PaydirektExpress orders

Under the menu item PAYONE → Protect you can configure credit and address checks as well as bank account checks.

Operating Mode

Here you can specify for the credit standing check whether the checks are carried out in test or live mode.

Credit Assessment

Here you can specify whether and in what form creditworthiness checks are to be carried out during the checkout process.

Address Validation

Here you can specify whether and in what form the address checks should be performed and how the OXID eShop should behave if certain results apply.

Bank details check

Here you can configure whether and in what form bank details should be checked during the checkout process when the payment type Direct Debit is selected.

Transaction Status redirects

Transaction Status Forwarding

Transaction status forwarding enables you to transfer the payment status to other systems, such as Materials Management or Logistics.

Transaction Status Mapping

The transaction status mapping is used to use the PAYONE status in order to have the orders processed according to your needs in an appropriate shop status.

Logs

Within the menu item Protocols/Logs you will find all information about processed payments, the communication with the PAYONE platform as well as the order overview.

Transactions

The Transactions submenu item displays notifications received from the OXID eShop of the transaction status of the PAYONE platform for each order and transaction. 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.

Overview

In the overview you can see all received and processed messages of the transaction status of the PAYONE platform. Filter options are available above the individual columns.

Transaction details

After selecting an entry in the overview, you will receive all transmitted transaction status information through the PAYONE platform to your OXID eShop. This allows you to track at any time which data your OXID eShop 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 logs

In the submenu API-Logs you will find all requests from the OXID eShop to the PAYONE platform as well as the corresponding answer of the PAYONE platform.

The only requests that are not contained in these logs are requests using the Client API. The reason for this is that these requests are sent directly from the buyer's browser (client) to the PAYONE platform for reasons of the Payment Card Industry Data Security Standard based on Ajax technology, so that your OXID eShop does not technically come into contact with sensitive credit card data.

Overview

In the overview you will find a list of all requests from the OXID eShop to the Server API with basic information. You can filter the display in the column headers by entering search terms.

The entire content of the Request and Response columns is searched. The content is described in more detail in the API Log Details.

API Log Details

After clicking on one of the requests listed in the overview, you will see all parameters of the request sent to the PAYONE platform as well as the corresponding response from the PAYONE platform.

Orders

The order overview is a standard functionality of the OXID eShop. The PAYONE tab has been added to this list in order to be able to check the payment status of an order.

Via the menu item Manage orders → Orders, which is available by default in every OXID eShop, the same overview including the PAYONE tab is displayed as under PAYONE → Protocols / Logs → Orders.

Overview

In the overview you will find a list of all orders with basic information. As with transactions and API logs, you can filter the display in the column headers by entering search terms.

PAYONE Tab

In the PAYONE tab you will find the transaction account in the context of the order, in which all receivables and payments are displayed. This is based on the OXID eShop requests via the Server API to the PAYONE platform as well as feedback on the transaction status from the PAYONE platform.
You also have the option of capturing payments for pre-authorized payment transactions and refunds.