Help · Sales & Checkout · Payment Methods

Set Up Payment Methods

Install payment methods, assign them to shipping methods, and restrict them by country, customer group, and order value. This includes PayPal, Stripe, Wero, and other providers, fees and cash discounts, text and logos, as well as cancellations and refunds. And the most common question: Why doesn’t a payment method appear at checkout?

At a Glance

  • Payment methods: Under Settings → Checkout → Payment Methods, install, set up, and enable or disable them using the status toggle. By default, only prepayment is installed.
  • Shipping and Payment: A payment method appears only for the shipping methods to which it is assigned. After installation, it is not yet assigned to any.
  • Restrictions: By module, based on the country zone of the billing address and order value, as well as by customer group and by customer.
  • Providers: PayPal, Stripe, Klarna, Amazon Pay, VR Payment, Unzer, Datatrans, Adyen, and payever. In Germany, you can offer these to customers via VR Payment or Unzer.
  • Cancellation and Refunds: For most providers, these are handled via the order status. Deleting an order in the store does not cancel anything with the provider.

In this guide


How the store determines which payment methods the customer sees

Each payment method is a module. During checkout, the store checks several conditions for each payment method. It only appears if all conditions are met.

ConditionWhere to configure it
The payment method is assigned to the selected shipping method.“Shipping and Payment” in the list of payment methods or shipping methods
The customer or customer group must be authorized to use the payment method.In the customer or customer group, under “Payment Methods”
The module is enabled.Status switch in the list or “Payment via …” in the module
The billing address is located in the permitted country zone."Zone for this payment method" in the module
The order value falls within the limits of the customer group.“Order Value” in the module
The module’s own rules are met, such as “Invoice starting at x orders,” country, and currency at the provider.in the module or in the account with the provider

The available payment methods appear in the checkout according to the “Order of Payment Modules”; the one already selected appears at the top. If there is only one, it is preselected. If an order costs nothing and weighs nothing—such as a free download—the store will only offer “No Fees / Free,” provided this module is installed. If no suitable payment method is found, the customer will see the message: “We currently do not offer any payment methods for this order. Please contact us!”

"Payment" checkout step in the store: "Prepayment" selected, with the description: "You transfer the total amount to our account in advance, and we ship the merchandise after we receive payment." and the bank details for Musterladen GmbH, IBAN DE00 0000 0000 0000 0000 00, BIC MUSTDEXXXXX; below that, Cash on Delivery and Invoice; on the right, the billing address: Erika Musterfrau, Musterstraße 1, 12345 Musterstadt, Germany

The checkout page displays only the payment methods that match the shipping method, customer, billing address, and order total; the description from the payment method’s text appears as soon as the customer selects it. Click to enlarge.


Set Up Payment Methods

Under Settings → Checkout → Payment Methods, you’ll find all the payment methods your store supports. Installed modules have a status toggle; for all others, the action menu only offers “Install.”

Set Up Together: Most store owners set up new payment providers together with us. Contact us by email or phone. We’ll walk you through provider selection, login credentials, assignment to shipping methods, and the test purchase—via remote access directly on your screen, if you’d like. The steps below show what happens during this process.
  1. Select “Install” for the desired payment method in the action menu.
  2. “Edit”: Enter the provider’s login credentials and start by working in test mode. Be sure to check “Enable this payment method” and save the module once, even if you don’t make any other changes (see note below).
  3. Enable it using the status toggle in the list or the “Payment via …” option in the module.
  4. In the “Shipping and Payment” action menu, enable all shipping methods for which this payment method should be offered. Without this step, it will never appear.
  5. Under the module’s fields, enter the texts for the checkout and order confirmation in each language (see Texts, Logos, Receipts).
  6. Place a test order, then switch the mode to “live” or enter the live login credentials.
Settings → Checkout → Payment Methods, with the columns Module Name, Accepted Shipping Methods, Status, and Order: Cash on Delivery (20) and Prepayment (10) with their shipping methods, PayPal (50) and Invoice (70) with the yellow note “Module not assigned to any shipping method!”, all four active; below them: Adyen, Amazon Pay, Pay on Pickup, Datatrans, and Datatrans Payment Page with the “Install” button

Newly installed payment methods such as Invoice and PayPal are not yet assigned to any shipping method; the message “Module not assigned to any shipping method!” links directly to “Shipping and Payment.” Click to enlarge.

Fields that almost every module has

FieldFunction
“Payment via …”enables or disables the payment method, similar to the status toggle in the
“Order of Payment Modules”Position in checkout, smallest number first
“Zone for this payment method (…)”Country zone in which the billing address must be located. “All country zones” means: no restrictions.
“Order Status” or “Order Status”Status assigned to new orders placed using this payment method. “Default” sets the default order status.
“Order Value”“Order Value Limits” table: a minimum and maximum value for each customer group (“from x €,” “up to x €”); 0 means no limit. Customer groups without their own row are not subject to limits.
Invoice, direct debit, “Pay on Pickup,” credit card, and “No Fees / Free” come with a default zone setting upon installation that may not exist in your store. In that case, the payment method will not be visible to anyone, even though the screen displays “All Country Zones.” Therefore, after installation, open the module once using “Edit,” select the desired zone, and save.
To disable it, use the status toggle—do not select “Uninstall.” Uninstalling deletes all settings, including login credentials, and removes the payment method from all assignments to shipping methods, customer groups, customers, and pickup locations.

Set Payment Methods by Shipping Method

Which payment methods the customer sees depends primarily on the selected shipping method. For example, you can offer cash on delivery only for package shipping and “Pay upon pickup” only for in-store pickup.

From the payment method

In the list of payment methods, the “Accepted Shipping Methods” column shows the assignment. In the “Shipping and Payment” action menu, under “Shipping methods selectable at checkout for this payment method,” enable all applicable shipping methods. If no assignments exist, the list will display “Module not assigned to any shipping method!”

From the shipping method

Under Settings → Checkout → Shipping Methods, you can do this in reverse via the shipping method’s “Shipping and Payment” section, specifically under “Payment methods selectable at checkout for this shipping method.” Both methods change the same assignment. By default, prepayment is assigned to the preconfigured shipping methods.

Click & Collect Locations

Under Settings → Checkout → Stores, each store inherits the payment methods of the “Pickup” shipping method. With “Payment Method Mode” set to “Define custom payment methods for this store,” you can select different payment methods for a specific store. If this selection is left blank, no payment method will be available there.

"Edit Shipping and Payment for 'Invoice'" screen with "Shipping methods selectable at checkout for this payment method:", and the note "All shipping methods that should be valid for this payment module must be selected." and radio buttons for each shipping method: DHL Yes, Shipping Cost 1 Yes, Free Shipping No

Under “Shipping and Payment,” enable the shipping methods for which invoicing is offered—in this case, DHL and Shipping Cost 1. Click to enlarge.

In the future, you’ll also be able to access “Shipping and Payment” as a tab directly from the payment method editing screen.from 4.10


Restrict Payment Methods by Country, Customer, and Order Value

Invoice only in Germany, invoice only for merchants, a payment method available only for orders above a minimum order value: You can set these rules in the module and for individual customers or customer groups.

By country

Select “Zone for this payment method” in the module. The country of the billing address is the determining factor. By default, there is a separate zone for each EU country, such as “EU – Germany,” as well as “European Union,” “Outside the European Union,” “All of Europe,” and “Rest of the World.” To create your own selection—such as Germany and Austria—go to Settings → Country / Tax → Country Zones and create a zone in the “Add” tab.

By Customer Group or Customer

Under Customers → Customer Groups, in the “Payment Methods” section, select “Custom selection for this customer group” and enable the desired payment methods. For an individual customer, go to the customer’s profile, select the “Payment & Shipping Methods” tab, and click “Select payment modules for this customer.” The selection made for the individual customer overrides the group’s settings, so be sure to enable all desired payment methods there.

By Order Value

In the module, under “Order Value,” create a row for each customer group with “from x €” and “to x €.” The order value is calculated based on the product price excluding shipping costs. Some providers also have their own limits, such as PayPal Invoice Purchase, which ranges from 5 to 2,500 euros.

Edit Customer, "Payment & Shipping Methods" tab, Payment Methods section: Note regarding customer group settings; select "Select payment modules for this customer" instead of "Apply group settings to this customer"; set "Invoice" and "Prepayment" to "Yes," and "Cash on Delivery" and "PayPal" to "No"

By selecting “Select payment modules for this customer,” an individual customer will only see “Prepayment” and “Invoice” instead of the options available to her customer group. Click to enlarge.

Guest customers belong to the customer group specified under Settings → Checkout → Customer Details → Customer Group Assignment for purchases without a customer account. If a payment method is missing only for guests, check the payment method selection and the “order value” for this group.
If customer groups have their own selection, a newly installed payment method will not appear there automatically. Enable it in each of these groups. The list of payment methods will display a yellow notification indicating this.

Why isn’t a payment method displayed at checkout?

Check these points in order. It’s usually due to one of the first three.

  1. Isa shipping method assigned? The list of payment methods shows “Module not assigned to any shipping method!” or the shipping method the customer selected is missing from “Accepted Shipping Methods.”
  2. Did you save the zone after installation? Open “Invoice,” “Direct Debit,” “Pay on Pickup,” and “Free of Charge” once by clicking “Edit” and then save them.
  3. Customer group or customer: The group or customer has its own selection where the payment method is missing.
  4. Is the module active? The status toggle is green.
  5. Zone: The country of the billing address is not included in the “Zone for this payment method.” For example, Switzerland does not belong to the “European Union” zone, but rather to “Outside the European Union” and “All of Europe.”
  6. Order value: The order value is below “from x €” or above “up to x €” for the customer group.
  7. Module-specific rules: such as “Invoice enabled/disabled for x or more orders,” “Allow invoice for the following shopping cart contents,” a different shipping address for cash on delivery, or an item marked “Block cash on delivery.”
  8. With the provider: The payment method is not enabled in your account with the provider or is not available for the country, currency, or amount. See the notes for PayPal, Stripe, and other providers.

Overview of Payment Methods and Providers

XONIC comes with these modules. For payment providers, you’ll need a contract and login credentials from their portal; the help texts in the module interface will tell you where to find the necessary information there.

ModulePurpose
PrepaymentBank transfer before shipment; installed by default
InvoicePurchase on account, payment to you
Cash on DeliveryPayment upon delivery, with a fee upon request
Payment upon pickupCash payment or payment upon pickup
Direct debit (SEPA)Direct debit with authorization; funds collected via SEPA file through your bank
No fee / FreeOrders over 0 euros
PayPal CheckoutPayPal, Pay Later, Invoice Purchase with Ratepay, Credit Card, Apple Pay, Google Pay
StripeCredit card via Apple Pay and Google Pay, SEPA Direct Debit, Klarna, iDEAL, EPS, Revolut Pay, Amazon Pay, and more
VR PaymentAll payment methods included in your VR Payment contract, including Wero
Klarna PaymentsKlarna Direct, with the options that Klarna approves for the purchase
Amazon Pay V2Amazon Pay with an Express button in the shopping cart
UNZER v2Payment methods associated with your Unzer account, including Wero
Datatrans Payment PagePayment methods associated with your Datatrans account, including cards and Klarna
Adyen, payeverPayment methods available through your account with the provider; payever also includes Santander’s installment purchase option

The “UNZER,” “Datatrans,” “Worldpay,” and “Financed Purchase via Santander Consumer Bank” modules are part of older interfaces. For new setups, use “UNZER v2,” “Datatrans Payment Page,” or payever. The “Credit Card” module captures card data directly in the store; instead, offer card payments through a payment provider.


Invoice, Prepayment, Cash on Delivery, and Direct Debit

You process these payment methods without a payment provider. The funds are deposited into your account, and you verify receipt of payment yourself.

Prepayment

Your bank account information is not a separate field. It appears in the payment method text: in the description when selecting the option, in the order summary, and in the order confirmation. Maintain these texts in every language (see Texts, Logos, Receipts). If prepayment is to be the only payment method, disable the others or assign only prepayment to the shipping methods.

Invoice

“Invoice after x orders on/off” only offers invoicing after a certain number of previous orders (“Invoice after x orders”). Orders are counted based on the statuses specified in “Orders are counted when order status...”. New customers and guests will never receive an invoice. There are no exceptions for individual customers: If you want someone to be able to purchase on account immediately, you must turn off the toggle. With “Allow Invoice for the Following Cart Contents,” you can restrict invoices to carts containing shippable items, downloads, or both.

Cash on Delivery

Enter the fee in the shipping method for each zone as a “Cash on Delivery surcharge” and enable the “Cash on Delivery Fee” module under Settings → Checkout → Summary. “Block Cash on Delivery for Different Shipping Addresses” disables cash on delivery when the shipping address differs from the billing address. Items marked with “Block Cash on Delivery” exclude cash on delivery for the entire shopping cart.

Direct Debit (SEPA)

The customer enters their IBAN and grants authorization by checking a box. In the module, enter the “Creditor Identification Number,” “IBAN,” and “BIC” for your account. Funds are collected via Orders → Direct Debit Export: The store generates a SEPA file, which you submit to your bank. You also send the advance notice to customers via email from there. There is no direct debit processing through the bank.

Edit screen for the Invoice module: “Payment by Invoice” yes, “Order of Payment Modules” 70, “Zone for this Payment Method (Invoice)” EU - Germany, “Order Status” Standard, “Allow Invoice for the Following Cart Contents” mixed, physical, and virtual: no, “Invoice starting at x orders on/off” no, “Invoice starting at x orders” 3, order statuses counted: Payment Received and Shipped, “Product Value Limits” table with the row “End customers from 0 to 1000 EUR”

Here, invoicing applies only to billing addresses in Germany and to end customers with a merchandise value of up to 1,000 euros; the “Invoice after x orders” option is disabled. Click to enlarge.


PayPal Checkout

A module for PayPal, “Pay Later,” purchase on account with Ratepay, credit card, Apple Pay, and Google Pay. You need a PayPal Business Account and a REST app within it with a Client ID and Secret. The older PayPal module is no longer available; new features are included with the shop update.

Login Credentials and Correct Account

Enter the REST app’s “Client ID” and “Secret”; set “Mode” to “sandbox” initially, then switch to “live” after testing. When you save the settings, the shop verifies the data and sets up the notifications (webhooks) directly with PayPal. The Client ID and Secret alone determine which PayPal account receives the funds. If the funds end up in the wrong account, enter the REST app credentials from the correct account.

Authorize First, Post Later

If “Post Payment” is set to “Checkout,” PayPal posts the payment immediately. If “Status” is selected, the payment is only authorized and will not be collected until you set the order status from “Payment Authorization” to another status, such as your shipping status. If this field is set to “Default,” the payment is never collected. For purchase on account, EPS, iDEAL, and Przelewy24, PayPal always processes the payment immediately.

Purchase on account with Ratepay

Enable “Allow Purchase on Invoice.” PayPal must activate your account for this; without activation, the store will disable the option again upon saving. Purchase on account is only offered to private customers with a billing and shipping address in Germany, in euros, for orders between 5 and 2,500 euros, and without coupons or downloads in the shopping cart. The customer provides their date of birth and phone number. Leave “Transfer shipping status (recommended)” enabled.

Credit Card, Apple Pay, Google Pay

Enable “Allow advanced credit card payments,” “Allow Apple Pay,” and “Allow Google Pay” after PayPal has activated your account for these methods; the links are provided in the help text for each field. Apple Pay also requires the verification file from PayPal at /.well-known/apple-developer-merchantid-domain-association to be hosted on your domain. A box in the module screen indicates whether it has been found.

“Pay Later” Notice

“Show PayPal Widget (Product Details)” and “Show PayPal Widget (Shopping Cart)” display the “Pay Later” notice. On the product page, it appears for prices up to 2,000 euros and—as long as the cookie notice is active—only after consent to “PayPal Marketing Solutions” has been given. In the shopping cart, the limit is 5,000 euros. If “PayPal Pay Later” is listed under “Disable Payment Methods,” it will not appear.

Express Button

“Allow PayPal Checkout (Express Purchase)” displays the PayPal button in the shopping cart, in the sidebar shopping cart, and on the login page. It appears only if PayPal is also assigned to the “Free Shipping” shipping method under “Shipping and Payment,” as Express Purchase uses this as a placeholder.

PayPal module editing screen: “Payment via PayPal” yes, Order 50, Zone All Country Zones, “Payment Posting” Checkout instead of Status, “Payment Authorization Status” and “Order Status” default, “Webhook Behavior” default, “Mode” sandbox, Client ID and Secret with placeholders, “Allow PayPal Checkout (Express Purchase)” and “Allow Virtual Goods Purchases” yes, “Allow Purchase on Account” no, with a link to enable this feature on PayPal

To test, use sandbox mode with the client ID and secret of the sandbox app; “Payment Posting” determines whether PayPal posts the payment immediately or only once the status changes from “Payment Authorization Status.” Click to enlarge.

Feedback from PayPal

When the payment is received, the store sets the order to the first payment receipt status. For declined or reversed payments, it sets the status to “Canceled,” and the order displays the message in red: “Payment DECLINED … do not ship any goods!” With “Webhook Behavior” set to “keepstatus,” the remaining responses do not change the status. PayPal Checkout does not use IPN notifications; a warning from PayPal regarding failed IPN messages pertains to an IPN address in your PayPal account, not the store.

Common pitfall: Use a separate REST app for each store, including a test store. If two stores share the same client ID, saving the module template in one store deletes the webhooks for the other. As a result, the bank details for purchase on account, the restoration of canceled orders, and cancellation notifications will be missing from that shop without anyone noticing. In the future, the shop will leave other shops’ webhooks untouched.from 4.10

Stripe

Through Stripe, you can offer credit card payments with Apple Pay and Google Pay, SEPA direct debit, Klarna, iDEAL, EPS, PayPal, Revolut Pay, Amazon Pay, and other methods. The customer pays on Stripe’s payment page.

Keys and Webhooks

Enter the “Secret Key” and “Public Key” from the Stripe dashboard under API Keys: use the test keys for testing and the live keys for production. When saving, the store creates the webhook in Stripe and automatically retrieves the “Webhook Secret” for a newly created webhook.from 4.9.135

Payment Methods

In the “Payment Methods” table, select the methods; each will appear as a separate payment option at checkout. “Credit Cards, Apple Pay, Google Pay” includes card payments along with Apple Pay and Google Pay, while “All Payment Methods” includes the methods that are active in your Stripe account. Each method must also be enabled in the Stripe dashboard; if it is not, the store will display a warning when you save.

If a method is missing

The store displays some payment methods only if they match the country and currency—for example, TWINT is available only in Switzerland in Swiss francs. Klarna does not appear for business customers as long as “Klarna for Business Customers (B2B)” is turned off, and it does not appear if the shipping address differs as long as “Klarna only when billing and shipping addresses match” is enabled. Stripe itself rejects other payment methods if the country or currency doesn’t match; the customer will then see an error message.

A common pitfall: If you enter a custom status such as “Payment Pending” under “Order Status (Asynchronously Paid),” and it is set to “Default,” SEPA direct debits that have not yet been collected will appear as paid orders. If the customer does not return to the store after payment, the store will not create the order until Stripe confirms the collection—often days later.

Stripe always processes payments immediately; there is no authorization with a later collection here. The guide “Express Checkout with Stripe” explains Apple Pay, Google Pay, and Link as an Express button in the shopping cart, as well as domain registration and restored orders.


Offer Wero

Wero is the payment method used by European banks. It’s up to you to decide whether to offer it. For customers in Germany, payments are processed via VR Payment or Unzer.

About VR Payment

You can enable Wero as a payment method for your Space in the VR Payment portal. There are no separate login credentials for Wero: In the shop, set up the VR Payment module and click “Synchronize Methods.” Wero is offered in euros for billing addresses in Germany, Belgium, France, Luxembourg, and the Netherlands.

Via Unzer

In the “UNZER v2” module, select Wero under “Available Payment Methods.” The shop retrieves this list from your Unzer account when you save, so Wero must be enabled there. It is offered for billing addresses in Germany and in euros.

Via Stripe

“iDEAL | Wero” in the “Payment Methods” table applies to customers in the Netherlands. “WERO Standalone (DE—separate Stripe activation required)” requires a separate activation by Stripe, which is currently only available as a preview version upon request. If your Stripe dashboard shows Wero as active, this usually refers to “iDEAL | Wero.”


Other Payment Providers

Key points for each provider: what to enter, what the modules can do, and common pitfalls.

VR Payment

A module for all payment methods active in your VR Payment Space, such as cards, Wero, PayPal, Klarna, and invoice. After activating the contract in the portal, create an Application User; enter the “Space ID,” “Application User ID,” and “Authentication Key” for both test and live environments, select the “Mode,” save, then click “Set up Webhook” and “Synchronize Methods.” You can also issue partial refunds by selecting “Refund” in the order. Test queries from the store appear in the portal as failed transactions after about 35 minutes; you can identify them by the “ xonic_probe ” attribute.

Amazon Pay

Enter the “Merchant ID,” “Store ID,” “Public Key ID,” and “Private Key” from Seller Central under Integration Central. “Allow Amazon Checkout (Express Purchase)” displays the Amazon Pay button in the shopping cart, but only in euros and not if an item marked “Block for Amazon Payments” is in the cart. With “Automatic Refund,” the store refunds the full amount when the order status is canceled; disable this if you want to process the refund yourself through Amazon.

Klarna

Enter the “Username (UID)” and “Password” from the Klarna merchant portal. The store displays only the Klarna options that Klarna has approved for the purchase; therefore, you must disable individual options in Klarna, not in the store. The payment is collected when the status is set to one of the “Activation Statuses.” Cancellations can only be made before the payment is collected; refunds must be processed in the Klarna portal.

Unzer

“UNZER v2” with the “Merchant ID,” “Private API Key,” and “Public API Key” from the Unzer portal under Settings → Keys. Select the payment methods under “Available Payment Methods.” When the status is “Canceled,” the store cancels or issues a refund through Unzer; when the shipping status is set, it reports invoice and installment purchases as shipped.

Datatrans

“Datatrans Payment Page” with “Merchant ID,” “Server-to-Server Password (API),” and “HMAC-SHA256 Key (Webhook).” Under “Payment Methods,” organize the methods into groups; leaving it blank selects all. You offer Klarna via Datatrans using the codes KLN or DIB. If “Automatic Settlement (autoSettle)” is set to false, the store does not settle the payment until the shipping status is set; without a shipping status, the payment remains only authorized. If set to “auto,” the setting in your Datatrans account applies.

Adyen and payever

Both display the payment methods enabled for your account with the provider. Adyen requires an API key and client key for both the sandbox and live environments, as well as a merchant account; you handle cancellations and refunds through the Adyen interface. With payever, the customer first selects the payment method on the payever page, including Santander’s installment plan.


Collect, Cancel, Refund

With most providers, the order status determines what happens on the provider’s end. You change the order status as usual; the store forwards the action to the provider and records the result in the history.

ProviderCollecting an AuthorizationWhen the status is “Canceled”Partial refund
PayPalStatus from “Payment Authorization Status”Full refund if “Automatic Refund” is enabledin the PayPal account
StripeAlways processes immediatelyFull refund if “Automatic Refund” is enabledin the Stripe dashboard
Amazon Paycreditsa full refund immediately if “Automatic Refund” is enabledon Amazon
KlarnaStatus from “Activation Statuses”Cancellation only before the payment is processedin the Klarna portal
VR PaymentShipping status when “Automatic Capture” is set to falseCancels a payment that has not yet been collected"Refund" button in the order, except for Klarna, invoice, and installment plans
DatatransShipping status when “Automatic Settlement (autoSettle)” is set to falseCancellation or credit note when “Automatic Full Cancellation” is enabledin the Datatrans backend; in the future, also via “Refund” in the order from 4.10
Unzer, payever–The shop cancels or issues a refund with the providerwith the provider
Adyen–No action required by the store; cancellation in the Adyen interfacein the Adyen interface
You define which statuses are considered “Cancellation,” “Shipped,” or “Payment Received” under Orders → Order Status: within each status using the “Cancellation,” “Shipped,” and “Payment Received” buttons. A bulk update without a selected status does not trigger a payment action.

Deleting an order in the store does not cancel anything with the provider. For instructions on how to modify, cancel, and process returns for orders, see the guide “Editing Orders.”


Fees and Cash Discounts by Payment Method

Surcharges and discounts per payment method are modules under Settings → Checkout → Summary. Install them there just as you would a payment method.

Fees for Payment Methods

Enable them by clicking “Calculate Fees.” For up to five payment methods, create a fee group for each: the payment method, “Custom Fee Title,” “Flat Fee” (net), “Base Fee (in %)”, “Includes Shipping Costs,” and “Tax Rate.” “Hide Fees in Checkout” hides the fee during payment method selection.

Cash-on-Delivery Fee

The “Cash on Delivery Fee” module calculates the “cash on delivery surcharge” based on the shipping method and applies it to the order, then sets the tax rate. The fee appears in the checkout next to the payment method. Note: The total line for the fee is currently labeled “Subtotal” instead of “Cash on Delivery Fee”; this will be corrected in an update.

cash discount

In the “Less Cash Discount” module, enable it by selecting “Enable Cash Discount for Payment Method,” choose the payment methods under “Payment Method,” and under “Discount,” set the minimum amount and discount rate for each customer group, either as an amount or as a percentage. Customer groups without a line item do not receive a cash discount.

If you select “All Payment Methods,” the store will deduct the cash discount for every payment method, including PayPal, Stripe, and express purchases. Therefore, select the payment methods individually if the cash discount is to apply only to prepayment.

The note “Less cash discount” appears in the payment method selection for payment methods with a single entry, such as prepayment or invoice, but not for the individual payment methods offered by providers like Stripe or PayPal. In the future, it will also appear there and, if desired, in the sidebar shopping cart.from 4.10


Texts, Logos, and Receipts

You can manage the text customers see for each payment method in the module for each language. Logos in the footer and the information on the invoice are configured centrally.

Texts by Payment Method and Language

In a module’s editing screen, the texts appear below the fields with a tab for each language (only for languages with “Admin Status” enabled under Settings → Languages / Currencies), or alternatively via the “CMS” action in the list: the description displayed when selecting a payment method, the text in the order summary, and the text in the order confirmation. For the English version—such as “Prepayment” with your bank details—fill out the English tab. You can change the name of the payment method itself, such as “Prepayment,” under Tools → xoLanguage.

Logos in the Footer

Under Settings → Design → Footer → Payment Methods in the Footer, select the logos and a linked page for each logo. You can choose from your installed payment methods as well as Visa, Mastercard, American Express, Diners Club, UnionPay, Apple Pay, Google Pay, Twint, PostFinance, Powerpay, and Wero. Revolut Pay, Klarna, and Amazon Pay can also be selected without a dedicated module. from 4.9.138

Payment Method on the Invoice

Under Settings → Design → Receipts, “Payment Method on Receipts: Display of Payment Method” determines whether only the provider (“PayPal”) or also the specific payment method used is displayed, such as “PayPal (Invoice Purchase with Ratepay).” from 4.9.34

Payment Terms

“Payment Terms on Invoice: Payment Methods” under Settings → Design → Receipts determines for which payment methods the invoice specifies payment terms. The number of days is set under Settings → Checkout → General → Payment Terms in Days.from 4.9.34

Lower section of the "Prepayment" module's editing screen with the language tabs "DE" and "EN"; "EN" tab is active: Editors $cms_vorkasse_email_footer, $cms_vorkasse_checkout, and $cms_vorkasse_description with English text and the bank details for Musterladen GmbH, IBAN DE00 0000 0000 0000 0000 00, BIC MUSTDEXXXXX, Bank Musterbank

Below the prepayment fields are the texts for the order confirmation, order summary, and payment method selection, with one tab per language—here, the English version. Click to enlarge.

With PayPal Invoice, the customer pays Ratepay. The invoice therefore hides your own bank account information and displays Ratepay’s bank account information instead. PayPal sends this data only after the order is placed, along with its own notification. If the invoice is generated beforehand, the bank account information will be missing; in that case, generate the invoice again.

Pitfalls

  • Payment method installed but not assigned to a shipping method: It will never appear. Watch for the message “Module not assigned to any shipping method!”
  • Zone not saved after installation: Invoice, direct debit, “Pay upon pickup,” and “No fees / Free” will remain hidden.
  • Uninstalling instead of deactivating: This deletes login credentials and all assignments.
  • Custom selection for the customer: This overrides the customer group’s selection. Enable all payment methods there that the customer should be able to use.
  • “Invoice starting at x orders”: New customers and guests do not receive an invoice.
  • PayPal with “Payment Booking” = Status: If “Payment Authorization Status” is set to “Standard,” the store will never collect the funds.
  • A single PayPal REST app for multiple stores: Saving changes in one store deletes the webhooks in the other.
  • Stripe without a status for pending payments: SEPA direct debits appear as paid before the funds are actually received.
  • Cash discount for “All Payment Methods”: Also applies to PayPal, Stripe, and Express purchases.
  • Texts in German only: Otherwise, English-speaking customers will see German payment instructions. The sample text for prepayment in the order summary is also in German by default in the English tab.


Checklist Before Going Live

  1. Each payment method is assigned to the appropriate shipping methods; nowhere does it say “Module not assigned to any shipping method!”
  2. "Zone for this payment method" has been deliberately selected and saved in each module.
  3. Customer groups with their own selections include all new payment methods, including the group for guest orders.
  4. Under Orders → Order Status, cancellation, shipping, and payment receipt statuses are set.
  5. The text for each payment method has been maintained in all languages, and the bank details for prepayment are correct.
  6. For payment providers: separate login credentials for each store, webhooks set up, and order statuses selected for successful and pending payments.
  7. For each payment method, a test order has been placed in test mode, along with a cancellation if the store is supposed to issue an automatic refund.
  8. Set the mode to “Live,” enter the live login credentials, and verify a real order.

Frequently Asked Questions

Why isn’t the “Invoice” payment method displayed at checkout?

Most often, the assignment is missing under “Shipping and Payment,” or the module was never saved after installation and the zone is incorrect. Next, check the billing address zone, the customer group selection, and “Invoice starting at x orders on/off.” All these points are listed under “Payment Method Missing in Checkout.”

Customers from Switzerland don’t see the “Invoice” option. Why is that?

Switzerland is not part of the “European Union” zone. In the module, select a zone that includes Switzerland—such as “All of Europe”—or create your own. The payment method must also be assigned to the shipping method for Switzerland.

How do I allow a specific customer to purchase on account?

In the customer’s profile, under the “Payment & Shipping Methods” tab, select “Select payment modules for this customer” and enable “Invoice” along with all other desired payment methods. Invoice must also be set up, active, and assigned to the shipping method. If “Invoice from x orders on/off” is enabled, the minimum order quantity also applies to this customer.

Can I set prepayment as the only payment method?

Yes. Disable the other payment methods or, under “Shipping and Payment,” assign only prepayment to each shipping method. If there is only one payment method, it will be preselected at checkout.

How do I change the prepayment text to English?

Under Settings → Checkout → Payment Methods, edit the prepayment option and fill in the “EN” tab below the fields (it appears when English is active in the “Status Admin” column under Settings → Languages / Currencies): Description, text for the order summary, and text for the order confirmation. You can change the name “Prepayment” itself under Tools → xoLanguage.

How do I disable a payment method, such as credit card?

In the list of payment methods, toggle the status switch off. If the credit card is processed through a provider, remove it from the selection there: for Stripe, in the “Payment Methods” table; for PayPal, under “Allow Advanced Credit Card Payments.”

Can I offer Wero?

Yes, for customers in Germany via VR Payment or Unzer. You activate Wero with the provider; you don’t need your own login credentials for it in the store. Via Stripe, Wero is currently only available as “iDEAL | Wero” for the Netherlands or with a separate activation through Stripe. Learn more under “Offer Wero.”

How do I set up the correct PayPal account?

Log in to the PayPal Developer Center with the desired PayPal Business Account, create a REST app there, and enter its “Client ID” and “Secret” in the module. The funds always go to the account associated with this app. You do not need a new module for this.

How do I set PayPal to “Authorization” instead of “Instant Booking”?

Set “Payment Posting” to “Status” and, under “Payment Authorization Status,” select the status at which the funds will be collected—for example, your shipping status. Set “Order Status” to a status such as “Pending” so that the order does not appear as “Paid” until the funds are collected.

Why doesn’t the invoice show any bank details when a customer pays via PayPal Invoice?

The customer pays Ratepay, not you. That’s why the invoice hides your bank details and lists Ratepay’s instead. PayPal only provides this information after the order is placed via a separate notification. If the invoice was generated earlier, regenerate it. If the information is permanently missing, check whether a second store is using the same PayPal REST app.

What happens if the customer doesn’t return to the store after making a PayPal payment?

With a standard PayPal payment, the store does not process the transaction until the customer returns. If the customer does not return, no money is transferred and no order is created. For Invoice Purchase, EPS, iDEAL, and Przelewy24, PayPal processes the payment immediately; in which case the store creates the order retroactively based on the confirmation from PayPal, provided that “Automatic Recovery (Drop-Off Scenario)” and “Transfer Cart Contents to PayPal (Recommended)” are enabled. Such orders are marked with an internal verification note.

Why isn’t Apple Pay appearing?

When using PayPal, Apple Pay requires activation by PayPal, the “Allow Apple Pay” setting, and the verification file on your domain. If the box in the module screen indicates that the file is valid but the button is still missing, it usually means that your domain’s registration with PayPal has expired; renew it in your PayPal account under “Manage Apple Pay.” With Stripe, Apple Pay is usually missing because the domain isn’t registered with Stripe or because the browser and device don’t support Apple Pay; see the guide on Express Checkout with Stripe for more details.

How do I disable automatic chargebacks for cancellations with Amazon Pay?

Disable “Automatic Refund” in the Amazon Pay module. Then, the store will no longer issue refunds when an order is marked as canceled, and you’ll process the refund yourself in Seller Central. The same option is available for PayPal and Stripe.

Can I disable individual Klarna options?

Not in the Klarna Payments module: The store displays the options that Klarna approves for the purchase. Disable them in your Klarna account. However, if you’re using Datatrans or VR Payment, you can select the Klarna options in the store under “Payment Methods” or “Available Payment Methods (optionally restrict).”

Can I process SEPA direct debits from the store?

Using the “Direct Debit (SEPA)” module, go to Orders → Direct Debit Export to generate a SEPA file, which you then submit to your bank. Your bank handles the collection itself. Alternatively, a provider such as Stripe can collect the direct debit (“SEPA Direct Debit (EU)” in the “Payment Methods” table).

How do I add more payment method logos to the footer?

Go to Settings → Design → Footer → Payment Methods to add more logos to the footer. You can choose from your installed payment methods and popular brands such as Visa, Mastercard, Apple Pay, or Wero. If a logo is missing from the selection, please contact us.

Why isn’t “Purchase on Invoice” visible during Express Checkout?

Customers who pay using the Express button skip the payment method selection. Invoice and PayPal Invoice are only available in the standard payment method selection during checkout. Both options are available side by side: The customer selects either the Express button or “Proceed to Checkout” in the shopping cart.

How do I respond to the PCI-DSS query from my payment provider?

If you offer card payments through a provider such as PayPal, Stripe, VR Payment, Unzer, Datatrans, or Adyen, the customer enters their card details into the provider’s forms; the store does not store them. Your provider will specify which questionnaire variant applies. The “Credit Card” module without a provider, on the other hand, collects card data within the store; do not use it.

Further Guides

We'll set up your payment methods together with you

Give us a call or send us a message: We’ll work with you to select a provider, enter the login credentials together—via remote access if you prefer—and test the system before going live.

Contact Support Now