Skip to main content

Payolution

Integration only for Callisto online stores

This page only contains instructions for integrating Payolution in Callisto online stores. For further information on using Payolution in Ceres online stores, refer to the detailed information in the plugin description available in the plentyMarketplace.

Payolution offers you and your customers many advantages and possibilities with the payment methods invoice and instalments. In your plentymarkets system, the payment method invoice is called Payolution Invoice. Instalment purchase is called Payolution Ins in plentymarkets.

1. Important notes

This chapter provides you with important information about integrating the payment provider Payolution in plentymarkets.

1.1. Payment process

For the the payment process via instalment purchase, the customer selects the payment method first. Afterwards, the customer is forwarded directly to Payolution. The additional content is made available in an iframe. The customer data is automatically transferred to the form on Payolution. The customer still has to accept the terms and conditions and specify how high the instalments should be. Once the data was entered and transferred, the customer is forwarded back to the My account area. There, the customer can take another look at the order.

The invoice payment process is even easier: The customer completes the purchase in the online store and is directly forwarded to the My account area. The entire purchase takes places in the online store.

1.2. SSL certificateYou need to have an SSL certificate in order to correctly use the payment method.

Ask your bank

Ask your bank whether it can process payments with iframe before you integrate this payment method.

1.3. Available Payolution payment methods

Below you will find an overview of the Payolution payment methods that are available for plentymarkets. They are displayed along with the corresponding System ID in parentheses.

  • Payment on invoice (2600)

  • Instalment purchase (2601)

Payolution Mangirkart

The payment method Payolution Mangirkart is currently without any function.

2. Registering with Payolution

Contact Payolution to register and set up an account. You will receive the access data that you need for setting up Payolution in plentymarkets.

3. Setting up Payolution in plentymarkets

In order to set up the interface for Payolution, proceed as described below.

Setting up the Payolution interface:

  1. Go to System » Orders » Payment » Methods.

  2. Place a check mark next to the setting Also show inactive.

  3. Open the folder International.

  4. Click on Payolution.
    → The Interface tab will open.

  5. Expand the client.

  6. Carry out the settings as desired. Pay attention to the information given in Table 1.

  7. Save the settings.

Table 1. setting up the Payolution interface
Setting Explanation

Sender;
Channel (PreCheck);
Channel (payment on invoice B2C);
Channel (payment on invoice B2B);
Channel (instalment purchase)

Enter the strings that you received from Payolution.

User login

Enter the user name that you received from Payolution.

User password

Enter the user password that you received from Payolution.

Company logo

Click on Browse…​ to upload an image with company name & logo that will be displayed in the header on the Payolution page.
Maximum size: 130 x 60 px.

Activate test mode

Activate the test mode and check the Payolution functions before working live with the system.

Minimum order value (B2C)

Enter the minimum order value for B2C customers according to the contract with Payolution. B2C customers have to reach this value when placing an order. Otherwise they will not be able to select Payolution as the payment provider.

Maximum order value (B2C)

Enter the maximum order value for B2C customers according to the contract with Payolution. B2C customers may not exceed this value when placing an order. Otherwise they will not be able to select Payolution as the payment provider.

Minimum order value (B2B)

Enter the minimum order value for B2B customers according to the contract with Payolution. B2C customers have to reach this value when placing an order. Otherwise they will not be able to select Payolution as the payment provider.

Maximum order value (B2B)

Enter the maximum order value for B2B customers according to the contract with Payolution. B2B customers may not exceed this value when placing an order. Otherwise they will not be able to select Payolution as the payment provider.

Minimum order value (instalment purchase)

Enter the minimum order value for instalment purchases according to the contract with Payolution. Customers have to reach this value when placing an order. Otherwise they will not be able to select Payolution instalment purchase as the payment method.

Maximum order value (instalment purchase)

Enter the maximum order value for instalment purchases according to the contract with Payolution. Customers may not exceed this value when placing an order. Otherwise they will not be able to select Payolution instalment purchase as the payment method.

Iframe width

Enter a value in pixels for the width of the instalment purchase input window in the online store.

Iframe height

Enter a value in pixels for the height of the instalment purchase input window in the online store.
*Note:* A scroll bar will be shown if the information displayed is larger than the width and height that you entered for the input window.

Bank details

If you work with Payolution, then you may not list any bank details other than the ones specified. Otherwise this can lead to errors.

4. Activating the payment method

Set up and activate the Payolution payment method in the Settings tab of the payment method. In addition, check the settings for Permitted payment methods in the customer classes and for Blocked payment methods in the shipping profiles.

5. Displaying Payolution in the online store

For example, your customers could see the following screen if they selected the payment method Payolution instalment purchase (German example):

DE Einstellungen Auftraege Zahlungsarten Payolution 05
Figure 1. Instalment purchase input window

6. Automatically sending shipping confirmations

Set up an event procedure to automatically send shipping confirmations to Payolution when the outgoing items are booked. You do not need a shipping confirmation for instalment purchases. As such, this event procedure should only be set up for payment on invoice.

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window will open.

  3. Enter name.

  4. Select the event listed in table 2.

  5. Save the settings.

  6. Pay attention to the explanations given in table 2 and carry out the settings as desired.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 2. event procedure for sending automatic shipping confirmations to Payolution
Setting Option Selection

Event

Order change: Outgoing items booked

Filter 1

Order > Order type

Order

Filter 2

Order > Payment method

Payolution Invoice

Procedure

Shipping > Send shipping confirmation to Payolution

Tip: Checking the shipping confirmation in the status history

Once you have set up this event procedure, the shipping confirmation will automatically be sent to Payolution when the outgoing items are booked. Go to Orders » Edit orders » Open order » Tab: Overview » Tab: Status history to check this process.

7. Automatically sending refunds

To send refunds automatically, an order status for credit notes is required. You can use one of the standard statuses or set up your own order status. This status is then only assigned to completed credit notes. These credit notes must not be changed after creation. Set up an event procedure to automatically send refunds to Payolution.

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window will open.

  3. Enter a name.

  4. Select the event listed in table 3.

  5. Save the settings.

  6. Pay attention to the explanations given in table 3 and carry out the settings as desired.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 3. event procedure for automatically sending refunds to Payolution
Setting Option Selection

Event

Order change: Status change

Select the status for the refund to Payolution.

Filter 1

Order > Order type

Credit note

Filter 2

Order > Payment method

Payolution payment method

Procedure

Payment methods > Send refund to Payolution

To top