Managing payment methods

Setting up payment methods for Callisto stores

This page only contains instructions for setting up payment integrations for Callisto stores. For Ceres stores, payment methods are integrated via plugins. To access the available payment plugins as well as instructions on how to install them, visit the payment section in the plentyMarketplace.

On this page, you will find detailed information on how to set up payment methods. You also find an overview of all non-contract payment methods, e.g. invoice or cash in advance, as well as related information about these payment methods. Learn how to set up the interfaces for payment methods and payment providers on an individual page for each payment method and provider. Find these pages in the Payment topic of the manual. Finally, you will find an overview of market payment methods. For a detailed description on how to activate market payment methods, refer to the pages of the corresponding markets.

1. Searching for a payment method

plentymarkets offers a large number of non-contract payment methods and payment methods for which a contract is required. Find the desired payment method quickly by using the search function.

Searching for a payment method:

Go to Setup » Orders » Payment » Methods.
Enter the name of the payment provider or payment method into the search field.
→ The results will be listed.
Click on the payment provider or payment method to open it.

The icons in the directory tree have the following meaning:

Check mark = active payment method
X = inactive payment method. Inactive payment methods can be displayed or hidden.
Folder = payment provider that offers several payment methods. Expand to display the payment methods.
Folder with question mark = folders that contain both active and inactive payment methods.

2. Setting up a payment method

Set up a payment method as described below. Note that payment methods must be permitted for customer classes in another menu. For further information, refer to the Permitting the payment method in a customer class chapter.

Setting up a payment method:

Go to Setup » Orders » Payment » Methods.
Place a check mark next to the setting Also show inactive.
Open the folder DE or International.
Click on the payment method.
→ The Settings tab opens.
Carry out the settings as desired. Pay attention to the explanations given in Table 1.
Place a check mark next to the option Active.
Save the settings.

Table 1. Settings of the payment method
Setting	Explanation
Language	The following options are saved for the language selected: Name, Info page, Info page (internal), Logo and Upload logo. This makes it possible to enter values for these options in various languages. The values for a language are activated as soon as a buyer selects the language in the online store.
Name	Enter the name that should be displayed in the online store and on invoices etc.
Info page	Select a category page of the type content or enter the URL of a website to provide information about the payment method.
Info page (external)	If you selected the option Info page (external) under Info page, then enter the URL of the info page here.
Countries of delivery	Select a country of delivery. *Note:* Only select a country of delivery when using the payment method in your online store. Do not select countries of delivery for payment methods for markets. A payment method for a market is not used in the online store. Therefore, this payment method is only activated in plentymarkets. It is not completely configured.
Client (store)	Select a client.
Logo	Select one of the following options for displaying the logo: Show standard logo = The logo that is saved in plentymarkets for this payment method is displayed. Do not show a logo = The logo that is saved in plentymarkets for this payment method is not displayed. Show upload logo = The options Logo view and Upload logo are displayed.
Logo view	If Show upload logo was selected from the Logo drop-down list, then the logo that was uploaded is displayed here.
Upload logo	If Show upload logo was selected from the Logo drop-down list, then upload an external logo here. Click on Upload files and select the logo that you want to upload for the payment method. Permitted data formats: GIF, PNG, JPG. Maximum size: 100 x 25 pixels.
Priority	Select the priority for displaying the payment method in the online store.
Costs: Flat rate or percentage	If the payment method results in additional costs, enter the percentage value or flat rate value. The choice depends on the conditions of your contract. Domestic (surcharge): Enter a flat rate or percentage value. The value that is entered will be taken into consideration for those orders that correspond to the system country. Once the customer has selected the payment method, these costs will be added to the particular order in the order process. The amount will be added to the total in the order and will not be displayed individually. Foreign countries (surcharge): Enter a flat rate or percentage value. The value that is entered will be taken into consideration for those orders that correspond to a foreign country. Once the customer has selected the payment method, these costs will be added to the particular order in the order process. The amount will be added to the total in the order and will not be displayed individually. Domestic (statistics): Enter a flat rate or percentage value. The value that is entered will be taken into consideration for those orders that correspond to the system country. Foreign countries (statistics): Enter a flat rate or percentage value. The value that is entered will be taken into consideration for those orders that correspond to a foreign country. For further information, refer to the Statistics page of the manual. *Important*: Do not enter a value into both fields. Pay attention to the conditions of your contract with the payment provider. Some payment providers do not allow you to hand over these fees to end customers.

Example for flat rate and percentage costs

If you want to add a surcharge, enter a positive value. For a surcharge of 1 percent, enter a percentage value of 1. For a surcharge of 1 EUR, enter a flat rate value of 1. If you want do enable a discount, enter a negative value, e.g. -2 for a discount of 2 percent.
Domestic country corresponds to the system country specified in the Where is the company based (for financial accounting purposes) setting in the Setup » Settings » Master data menu. If you work with clients (stores), then you can also use your standard country of delivery as the country where your company is based. You can find the setting in the Setup » Client » Select client » Order process » Settings menu. You can create more detailed discounts for payment methods with the help of the plentymarkets discount system. For further information, refer to the Discount based on payment method page of the manual.

3. Specifying the default payment method

Proceed as follows to specify the payment method to be set by default in the order process in your online store.

Specifying the default payment method:

Go to Setup » Client » Select client » Orders.
Select a payment method from the Default payment method drop-down list.
Save the settings.

4. Permitting the payment method in a customer class

You need to permit payment methods in the basic settings of your customer classes. These settings also relate to the standard end customers. New payment methods need to be added to the list of permitted payment methods. Vice versa, you can exclude payment methods from this list to prevent the payment methods from being used by a particular customer class. After having set up a new payment method in your system, check the settings under Permitted payment methods for each of your customer classes. For further information, refer to the Creating a customer class page.

SSL certificate and encryption

We generally recommend that you use SSL encryption for your online store if you work with payment data and customer data. This is required for payment methods that work with an iframe.

5. Offering a discount based on the payment method

The discount based on the payment method is a sort of early payment discount in plentymarkets. You offer customers a discount if they use one or more payment methods. Learn how to set up this discount on the Discount based on the payment method page. Besides, enter information about early payment discount and valuta directly in the data record of a customer.

6. Non-contract payment methods

Non-contract payment methods are payment methods that can be used in your online store without setting up an interface. Table 2 provides an overview.

Table 2. Overview of non-contract payment methods
Payment method	Explanation
Pay upon pickup	Use this payment method to allow your customers paying cash when picking up an item. Then, manually book the incoming payment in your system. Assign the payment to an order afterwards.
Cash sale / cash card	Use the Cash sale / cash card payment method, e.g. with your plentyPOS system in your stationary retail store, enabling your customers to pay cash or with cash card. Incoming payments will be transmitted from the cash card terminal or the POS system to your plentymarkets back end.
Credit card	The buyer transmits their credit card data to the seller, e.g. in the online store. The item is shipped as soon as the payment is received. *Important: For data protection reasons, the payment method credit card (manual processing)* cannot be used in a plentymarkets online store. Use a different payment method in your online store or use an individual solution for your customers.
Debit	The seller receives the bank details from the buyer and is allowed to collect the amount due from the bank account of the buyer. You can offer a payment method globally or for certain customers only. *Important*: Customers are able to cancel debits at their banks.
Cash on delivery	The buyer pays for the item upon receipt. The delivery person collects the payment and writes a receipt. *Important*: A fee is charged for cash on delivery orders.
Invoice	With this payment method, the customer can order an item via invoice. Payment is made after the item has been received. To pay for the item, the customer receives an invoice document with the bank details of the seller. Incoming payments have to be imported and assigned to orders in the plentymarkets system. You can offer a payment method globally or for certain customers only. For further information about this payment method, refer to Carrying out settings for the purchase on invoice.
Cash in advance	In this case, the buyer receives a message with the order data and the seller’s bank details. After the buyer has paid for the item, the payment must be imported into your plentymarkets system. Then, the items will be delivered. Learn how to make your bank data available to your customers on the Providing bank data page.

Carrying out settings for the purchase on invoice

In the advanced settings of the payment method Invoice, you specify that purchasing on invoice is not allowed for guest accounts, for example. To carry out the settings for the payment method Invoice, proceed as follows.

Advanced settings

Note that the following requirements must be met in order to use the advanced settings for purchase on invoice:

Use of the standard design Callisto (Version 3.5 or higher)
Use of the plentymarkets CMS tools (Version 1.0.18 or higher)
Use of the individual order process

Carrying out settings for the purchase on invoice:

Go to Setup » Orders » Payment » Methods.
Place a check mark next to the setting Also show inactive.
Open the folder International.
Click on Invoice.
→ The Settings tab opens.
Click on the Interface tab.
Expand the client.
Carry out the settings as desired. Pay attention to the explanations given in Table 3.
Save the settings.

Table 3. Settings for payment method **Invoice**
Setting	Explanation
Basic settings
Show bank details	Activate to display the bank details in the order process and the order history. For further information, refer to Displaying bank details in order process.
Show designated use	Activate to display the designated use in the order process and the order history. For further information, refer to Displaying bank details in order process.
Advanced settings
Invoice address and delivery address must match	Activate if the invoice address and the delivery address must match when purchasing on invoice.
Do not allow purchase on invoice for guest accounts	Activate to allow the purchase on invoice for registered and logged in users only.
Minimum number of orders	Enter a minimum number of orders to be completed by the customer with a different payment method before allowing the purchase on invoice.
Maximum invoice amount	Enter the amount that must not be exceeded when purchasing on invoice.
Minimum amount for purchase on invoice	Enter the amount that must be exceeded when purchasing on invoice.

7. Shipping without payment

Some payment methods require items to be shipped before the payment was received, e.g. with payment on invoice. If the stock is limited to net stock, then the system will check whether stock is available and will set the corresponding order in status 4 or 5. To solve this, go to Setup » Orders » Settings and select YES for the option Status changes to 4 instead of 5 if stock is missing. If there is no limitation set up for the stock, then the order will be placed directly in status 5.

The following payment methods require shipping before payment:

Invoice
Debit
Cash on delivery
Amazon
Credit card (manual processing)
Coupon
RatePAY invoice
MeinPaket payments
Hitmeister payment
PAYONE cash on delivery
PAYONE invoice

For further information, refer to the Stocks page of the manual.

8. Payment methods for markets

Payment methods for markets are payment methods which are necessary to flag incoming payments from integrated markets. In general, the market payment methods do not have to be completely set up. They only have to be activated. Not activating the payment method can cause problems during payment processing. Learn how to activate the payment methods for markets on the respective markets' pages. Table 4 provides an overview.

Table 4. Overview of payment methods for markets
Payment method	Explanation
Amazon	Payment method for orders that are imported into your plentymarkets system from Amazon. Activate the Amazon payment method.
BOL.com	Payment method for orders that are imported into your plentymarkets system from bol.com. Activate the BOL.com payment method.
Cdiscount	Payment method for orders that are imported into your plentymarkets system from Cdiscount. Activate the Cdiscount payment method.
Check24	Payment method for market Check24. Activate the Check24 payment method.
eBay purchase on invoice	Payment method for purchase on invoice on eBay. Activate the eBay purchase on invoice payment method.
Flubit	Payment method for orders that are imported into your plentymarkets system from Flubit. Activate the Flubit payment method.
Fruugo	Payment method for orders that are imported into your plentymarkets system from Fruugo. Activate the Fruugo payment method.
GartenXXL.at	Payment method for the GartenXXL.at market. Activate the GartenXXL.at payment method.
GartenXXL.de	Payment method for the GartenXXL.de market. Activate the GartenXXL.de payment method.
idealo Checkout	Payment method for the market idealo Direktkauf. Activate the idealo Checkout payment method.
Neckermann payment	Payment method for the Neckermann.at market. Activate the Neckermann.at payment method.
Netto	Payment method for the market Netto. Activate the Netto payment method.
OTTO Direktversand	Payment method for the OTTO Direktversand interface. Activate the OTTO Direktversand payment method.
Otto Payment	Payment method for the OTTO Cooperation and OTTO Integration interfaces. Activate the OTTO Payment payment method.
PIXmania Payment	Payment method for the PIXmania market. Activate the PIXmania payment method.
Rakuten	Payment method for the Rakuten market. Activate the Rakuten payment method.
real.de Payment	Payment method for the real.de market. Activate the real.de payment method.
Shopgate Payment	Payment method for the Shopgate market. Activate the Shopgate payment method.
Yatego invoice	Payment method for the Yatego market. Activate the Yatego invoice payment method.
Zalando payment	Payment method for the Zalando market. Activate the Zalando payment payment method.

9. Rounding differences

Some payment providers require you to specify the item quantity per stock unit as well as the unit price rounded to exactly 2 decimal places. If items are discounted, then this can lead to discrepancies in the way that plentymarkets and the payment provider calculate the total. Discrepancies frequently occur for large quantities of items with low prices per stock unit. In such cases, the payment provider will calculate the discount per item and then multiply it by the entire quantity of items. In plentymarkets, the discount is applied to the total value of items. [table-rouding-differences-discounts] provides you with an overview of how a 5 percent discount is calculated for large quantities of items. It shows you which rounding differences are caused if the discount is calculated per item (payment provider) and if the discount is calculated for the total value of items (plentymarkets).

Table 5. Rounding differences for discounts
Quantity	Unit price	Total price	Unit price minus 5% discount	Discounted unit price, rounded	Payment provider	Total price minus 5% discount	Discounted total price, rounded	plentymarkets
10	2.25	22.50	2.25 - 0.1125 = 2.1375	2.14	21.40	22.50 - 1.125 = 21.375	21.38
15	3.75	56.25	3.75 - 0.1875 = 3.5625	3.56	53.40	56.25 - 1.875 = 53.4375	53.44
				Total:	74.80	Total: 74.8125 (basis for plentymarkets)	Total:	74.81

In this case, the total difference is 1 cent. If only the first item was counted, then the difference would be 2 cents. If only the second item was counted, then the difference would be 4 cents.

Transaction refused

Such differences, even though they are minor, can cause the payment provider to refuse the transaction.

Offering other payment providers or item bundles

If you encounter such problems, you can offer alternative payment providers who do not have this problem or that you contact the payment provider to discuss a solution. You can also avoid this phenomenon by offering item bundles for those items that typically cause rounding differences (items with low prices).