Nets Easy

Nets Easy Integration with Omnium

Omnium supports Nets Easy (formerly DIBS, now part of Nexi) for payment processing with the following features:

• Authorize payments via hosted payment page
• Capture payments (full or partial)
• Cancel payments / release authorization
• Credit/Refund payments with tax-aware handling
• Update Merchant Reference after order creation
• Get Details - Retrieve payment information from Nets Easy

---

Setup Instructions

Configuration Path

1. Navigate to: Configuration > Settings > Payment > Payment Types > "..." > Add

2. Fill out the required fields as outlined below.

---

Required Fields

---

Base URL Options

---

Additional Configuration

---

Supported Operations

---

Order Lines Requirement

Nets Easy requires order lines for most operations:

• Authorization - Order lines required
• Capture - Order lines required (validated against capture amount)
• Refund - Order lines required for item-level tracking

---

Special Features

Tax-Aware Refund Handling

When processing refunds, Omnium automatically handles tax calculations:

1. Prorated Distribution - Refund amount is distributed proportionally across return items based on their extended price
2. Tax Recalculation - For each credited line item, tax amounts are recalculated based on the tax rate
3. Automatic Rounding Correction - Small discrepancies (less than 1 currency unit) between the sum of distributed amounts and the total refund are automatically adjusted

This ensures accurate tax reporting even for partial refunds.

Update Merchant Reference

After an order is created, you can update the merchant reference (order number) in Nets Easy. This is useful when the order number changes during processing, such as when converting from a cart to an order.

Webhook Events

Nets Easy sends webhook notifications for payment events. The following events are registered:

• Payment reservation created
• Payment reservation failed
• Payment charge created
• Payment charge failed
• Payment refund completed
• Payment refund failed

---

Amount Handling

Nets Easy uses integer amounts (minor units/cents):

Omnium handles the conversion automatically.

---

Capture Behavior

When capturing a payment:

• Order lines are validated against the capture amount
• The sum of order line amounts must match the capture amount
• A Charge ID is returned and stored for refund operations
• Partial captures are supported

---

Refund Behavior

When processing refunds:

1. Return items are mapped to Nets Easy order lines
2. Tax amounts are calculated separately for each line
3. Shipment costs can be refunded as a separate line item
4. Rounding discrepancies are automatically corrected

Refund Limitations

The refund amount cannot exceed the captured amount. Partial refunds are supported with item-level granularity.

---

Error Handling

Nets Easy errors are displayed on the order in the Errors section.

Common Errors

---

Limitations

• Release Remaining Authorization: Nets Easy does not support releasing remaining authorizations independently from a charge. You'll need to capture or cancel the full amount in these cases.

---

Payment Flow

1. Customer initiates payment - Hosted payment page URL is generated
2. Customer completes payment - Redirected to Return URL
3. Webhook notification - Omnium receives payment status update
4. Order processing - Capture when ready for fulfillment
5. Returns - Refund through returns workflow

---

Configuration Reference

Payment Service

Netseasy

Supported Currencies

All currencies supported by Nets Easy (NOK, SEK, DKK, EUR, etc.)

API Authentication

Bearer token authentication using the API Token (Client Secret).