Skip to main content
Academy Community Sign in

BS Payone

  • Updated

Table of contents 

Connection to BS PayOne

With the "Payone" module you can create and evaluate the Payone payment method.

The payment method retrieves the invoice details from PayOne and creates the invoice free text. At the same time it reports the goods as shipped. At the moment the "Payone" Invoice" payment method is supported.

Furthermore, you can pick up Payone in the incoming payment via the business accounts.

Payone as payment method

Under Administration → Settings → Payment methods → NEW you can create for PayOne as a new payment method.

Payment method settings

In the general payment method settings it is important that under module "Payone" is selected. You can choose anything else as needed.

 

Payone Settings

The required access data / settings can be found at https://pmi.pay1.de/. can be viewed. (Configuration → Payment Portals → API Parameters / Configuration → Accounts), are required: Field in XentralField in PayoneMerchant IDLogin: Account IDAccount IDConfiguration -> Accounts IDPortal IDPayment Portals: IDPayment Portal KeyConfiguration -> Payment Portals -> Edit -> Advanced: Key

The hash procedure for authentication may change on the part of PayOne. Therefore the used method can be changed in the settings from 'MD5' (currently supported) to 'SHA 384' in the settings. The used procedure can be found under Configuration → Payment portals → edit → Advanced: Procedure hash value check.

Payone settings in the store module

In the store module, the "Authorization" must be set to "Preauthorization".

For more information, see the integration guide with WooCommerce store.

PayOne as business account

Administration → Settings → Accounting → Business accounts

There is also the possibility to create PayOne as a business account.

Note: For the connection it is necessary to set up an FTP server. However, this has to be set up by yourself. Xentral only offers the possibility to fetch such a FTP server, but cannot provide or maintain an FTP server for each customer. Online there are some providers who offer such a FTP server for rent. If such a server is available the accesses can be transmitted to Payone and entered in the Payone interface in Xentral. This procedure is sufficient to complete the connection successfully. 

The connection of the business account is especially useful if the option "Treat as invoice" has been set in the Payone module.

Requirements

  • Activate Payone Report for customers
  • Report is stored at Payone via FTP on server or locally
  • This data must be picked up regularly in Xentral
  • Per live import one file is collected and deleted from the server. If several files are to be collected, the procedure must be repeated until no more bookings are found.

Settings in xentral

Select BS Payone as the account type.

FTP directory:

In the business account under the item Live Import you can enter this access as follows:

FTP_HOST=>192.165.0.21;
FTP_USERNAME=>username;
FTP_PASSWORD=>password;
FTP_PORT=>port;
FTP_DEBUG=>;
FTP_SSL=>1/0;
FTP_SUBDIR=>;

FTP_HOST=> The server where the FTP file is stored
FTP_USERNAME=> Username of the FTP host
FTP_PASSWORD=> Password of the FTP host
FTP_PORT=> Server port, if port other than port 21, if empty port 21 is used
FTP_DEBUG=>
FTP_SSL=> With specification of 1 you can activate SSL, if empty SSL is not used
FTP_SUBDIR=> Subdirectory from where the file is stored by BS Payone
optionally you could enter the variable API_DAYS:

API_DAYS=>n;
DAYS=>n;
DAYS=>n;

API_DAYS (DAYS, DAYS)=>n (with n is a positive number from 0 - 29 to specify the period in days to be collected. Default value is 5)

SFTP instead of FTP

If you use a SFTP server then add the following line in the code above at the end: SFTP=>1;

Related articles