Checkout for Shopware App

Installation

Installation

1. Install the Nexi Checkout app via Shopware Extension Store.

2. After successful installation:

   • Navigate to My Extensions to see the app.
   • Use the toggle to Activate/Deactivate the app.
   • Click the Configuration button to set up the app.

Configuration

Configuration

Access the Configuration page to set up the Nexi Checkout integration:

Key Settings:

• Live/Test Keys: Enter your Nexi integration keys.
• Live Mode: Toggle ON to enable production environment.
• Checkout Flow:
  • Hosted: Opens payment in a separate page.
  • Embedded: Payment occurs within your checkout page.
• Auto-Charge: Automatically charge the customer upon successful payment (for compliant products/services only).
• Split Payment:
  • ON: Users select specific payment methods (e.g., Klarna, PayPal).
  • OFF: Only "Nexi Checkout" is displayed.
• Terms & Conditions URL: Provide a full link to your policy page. Click Save to apply the settings to the selected sales channel.

The following table lists all the settings you can configure in the administration area for the Checkout module:

By default payment methods will be called Nexi Checkout Embedded | Nexi Checkout and Nexi Checkout Hosted | Nexi Checkout. If you want to change the name you have to go to Settings > Payment Methods and click Edit details button next to payment methods.

Order Management

Order Management

View Order Details

1. Go to Orders → Select an Order
2. Under the Details tab, scroll to the bottom to view Nexi-related information

order details

Cancel Payment

• Click Cancel Payment (available if the payment hasn't been charged)
• Confirm the action via the popup

cancel payment confirmation popup

• Order status changes to Cancelled

Cancelled status

• Charging is disabled once cancelled

Disable button

Klarna

The payment method Klarna requires a phone number to function properly. To ensure that Klarna will appear as a payment option in the Nexi Group payment window, it is essential to configure the phone number field correctly. For more information, please refer to the Klarna guide.

To add the phone number field in Shopware 6, follow these steps:

• Navigate to Settings > Shop > Log-in & Sign-up.
• Check the box for Show phone number.
• Check the box for Phone number field required.

To learn more, visit Shopware 6's documentation.

Sales Channel settings

Sales Channel settings

Assign Nexi Checkout to your desired sales channel:

Sales channel settings

• Go to Sales Channel settings.
• Scroll to Payment and Shipping.
• Assign Nexi Checkout to the Payment Methods field.
• Set it as the default payment method.

Payment methods settings

Payment methods settings

Access all Nexi-supported payment methods:

1. Go to Settings → Payment Methods.

2. Modify or toggle ON/OFF any supported methods:

3. Sofort

4. Klarna

5. Google Pay

6. Applepay

7. Vipps

8. Paypal

9. Mobilepay

10. Trustly

11. Swish

12. SEPA Direct Debit

13. Installment

14. Invoice

15. Nexi Checkout - Cards

16. Nexi Checkout Displayed if Split Payment is OFF

Availability rule

Default availability rule of each payment method is following global rule at Nexi - Payment methods. Any additional rule must be setup at Availability Rule section for each payment method.

Example: To make PayPal available only for Swedish customers:

1. Click Edit Details under PayPal
2. Scroll to Availability Rule
3. Create/select a rule for Sweden-based billing addresses
4. Save changes

Split Payment

Split Payment affects how payment methods are shown to the user at checkout.

Setup:

Go to Configuration → Toggle Split Payment ON or OFF → Click__ Save.__

Split Payment OFF

• A single option, Nexi Checkout, is displayed
• The customer proceeds to select their preferred method within the Nexi interface

### Split Payment ON

• Users will see individual Nexi-supported payment methods (e.g., Klarna, PayPal, Swish)
• Each method is selectable directly on the Shopware checkout page.

Checkout Flow: Hosted & Embedded

Checkout Flow: Hosted & Embedded

Setup:

• Go to Configuration → Select Hosted or Embedded under Checkout Flow → Click Save

Hosted checkout_

• Users are redirected to a separate Nexi page after clicking Submit order.

Checkout page Hosted page

• After payment, they are redirected to the Thank You Page with Nets ID. thank you page

Embedded checkout

• Payment iframe appears directly on your checkout page after clicking Submit order

Checkout page embedded checkout

• After payment is completed, navigate user to Thank You Page with Nets ID. thank you page

Manual & Auto Charging

Manual & Auto Charging

Auto Charge

• Automatically charges customer after successful payment
• Admin cannot cancel or manually charge

Disable button

Manual Charge (Auto-Charge OFF) Admin can manually charge by themselves.

• Charged button is activated and Admin have to charge order manual

manual charge order

Charge by amount

• Click Charge → Uncheck Select items to charge checkbox → Enter full or partial amount → Click Charge.

charge by amount ** Note: Amount must be greater than 0.

Charge by items

• Select number of items from the list
• Click Charge to process selected items

charge by items

Transaction details Transaction details is default expanded, hide the transaction logs by clicking Hide transaction logs.

transaction logs

Refund

Refund

• Click Refund in the charge log

charge logs

Refund by amount

• Uncheck Select items to refund checkbox → Enter full or partial amount → Click Refund

refund by amount

Note: Amount must be greater than 0

Refund by items

• Select number of items → Click Refund to submit

refund by items

Subscriptions

Subscriptions

Subscription order Merchants can follow Shopware’s guidelines to set up subscriptions: Shopware 6 - Settings - Subscriptions.

Only Nexi Checkout - Cards (when Split Payment is ON) or Nexi Checkout (when Split Payment is OFF) is available for Subscription orders.

Subscription order behavior A subscription will always be created and shown in the Subscriptions list with the status Active, whether the initial payment is successful or not.

• Subscription list

Here’s how the system handles payments:

• ✅ If the payment is successful: A sub-order will be generated based on the subscription’s defined interval. The payment for this sub-order will be automatically charged.

• ❌ If the payment fails: An order is still created, but its assets (e.g., downloads, content, etc.) will be inaccessible to the buyer. The subscription status will change depending on the next scheduled payment:

• First failed payment: The subscription remains Active, and the system will try again on the next scheduled payment date.

• Second (or subsequent) failed payment: The subscription status changes to Payment failed, and no more sub-orders will be created

subscription-failed-email

Troubleshooting

Below are some of the most common configuration errors, their cause and steps that you can follow to solve them.

Nexi Group payment app is not visible as a payment method

• Ensure the Nexi Group app is available in the right Sales Channel in the app configuration.
• Under the Sales Channel section, select your Shop Name under General settings. Add desired payment methods from the Nexi app.
• Temporarily switch to the Shopware 6 standard template. Custom templates might need additional changes to ensure correct display. Consult with your web designer or developer.

Nexi Group payment window is blank

• Ensure your integration keys in the Nexi Group app settings are correct and do not contain additional blank spaces.
• Temporarily deactivate third party plugins that might affect the functionality of the app.
• Check if there are any temporary technical inconsistencies: https://easy-status.developers.nets.eu/

Payments in live mode don't work

• Ensure you have an approved Live Checkout account for production.
• Ensure your Live Checkout account is approved for payments with the selected currency.
• Ensure payment method data is correct and supported by your Checkout agreement.