Kustom Checkout

Kustom Checkout Integration with Omnium

Omnium supports Kustom Checkout, providing the following features for managing payments:

• Capture payments (full or partial)
• Cancel payments
• Credit/Refund payments
• Release Remaining Authorization when necessary
• Update Merchant ID/Order ID during conversion from cart to order
• Update Authorization to reflect changes in order value without creating a new order
• Extend Authorization Time before expiration
• Update Shipment Information with tracking details after capture
• Retrieve Settlements/Payouts for reconciliation

This integration allows seamless payment management, helping you stay flexible in handling orders and payments.

Setup Instructions

Follow these steps to configure Kustom Checkout in Omnium and get everything working smoothly.

Configuration Path

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

2. Select Kustom Checkout. Omnium fills in the Payment Service, Provider Name, Display Name, Base URL, Vue Template and logo for you - the table below is what those values are, and what to check if you are editing an older configuration.

3. Fill in your Merchant ID and API Token.

Required Fields

Older configurations may use klarna-v3-payment as the Vue Template and any of KlarnaV3, KlarnaCheckout or Klarna as the Unique Payment Name. Those keep working. Move a configuration to kustom-checkout-template when convenient: the older template only completes the return from the checkout when the configuration is named exactly KlarnaV3.

Base URL Options

Following Klarna's rebrand to Kustom, the API is served from kustom.co. Select the environment from the Base URL dropdown:

There is no regional split - the same pair serves every market.

Retired klarna.com hosts

Klarna's API hosts have been switched off and every configuration has been moved to Kustom, so the Klarna options are gone from the Base URL dropdown. The old shortcut values (eubaseurl, eutestbaseurl, nabaseurl, natestbaseurl) are still resolved to the matching Kustom host, so a value left behind anywhere keeps working - it simply shows in the editor as a custom URL rather than as one of the two environments.

Credentials were unchanged by the move: only the host differs.

Additional Configuration

Display Options

Authorization Settings

Market & Store Restrictions

Operational Settings

Priority Settings

Reporting

Advanced Features

Update Authorization Amount

When enabled via Enable Update Authorization Amount, you can update the authorized amount on an order without creating a new Kustom order. This is useful when:

• Order value changes after authorization (e.g., item quantity adjustment)
• Customer adds or removes items before capture

The update is performed through the order's payment actions in the GUI.

Extend Authorization Time

Kustom authorizations have an expiration time. When enabled via Enable Extend Authorization Time, you can extend the authorization before it expires. This is useful for orders with longer fulfillment times.

Shipment Information Updates

After capturing a payment, you can update the shipment information with:

• Shipping Company/Carrier: The name of the shipping carrier
• Tracking Number: The shipment tracking identifier
• Tracking URI: A link to track the shipment
• Shipping Method: The type of shipping (e.g., postal delivery, pickup point, store pickup)

This information is sent to Kustom and can be displayed to the customer.

Settlements/Payouts

Omnium can retrieve settlement and payout data from Kustom for reconciliation purposes. Settlement data includes:

• Sales transactions: Captured payments
• Refund transactions: Credited/refunded payments
• Fee transactions: Kustom processing fees

Settlement data can be filtered by date range and currency.

Get Payment Details

When Get Details From Provider is enabled, you can fetch real-time payment information from Kustom, including:

• Current order status
• Captured amount vs. remaining authorized amount
• Refunded amount
• Order lines
• Capture history with tracking information
• Authorization expiration date

Kustom Payment Link

Alongside Kustom Checkout, Omnium supports Kustom Payment Link (previously Klarna In-Store) for physical retail locations. It uses Kustom's hosted payment page, sent to the customer by SMS or email.

Setup for Kustom Payment Link

Add it the same way - Configuration > Settings > Payment > Payment Types > "..." > Add, then select Kustom Payment Link. Omnium fills in these values:

Bad value: merchant_urls.checkout (must be a valid http or https URI),
merchant_urls.terms (must be a valid http or https URI),
merchant_urls.confirmation (must be a valid http or https URI)

Older configurations use klarna-in-store-payment as the Vue Template, which still works. Note the hyphen between "in" and "store": klarna-instore-payment does not resolve to any component and the payment panel will fail to render.

Kustom Payment Link Flow

1. A Kustom checkout order is created
2. A hosted payment page (HPP) session is generated
3. A payment link is distributed to the customer via SMS or email
4. The customer completes payment on the hosted page
5. The system polls for session completion
6. On completion, an authorization transaction is created
7. Standard capture/refund flow proceeds from there

Refund Limitations

Standard Refunds

Standard refunds are supported for all Kustom markets. You can perform:

• Full refunds: Refund the entire captured amount
• Partial refunds: Refund a portion of the captured amount with specific order lines

Return Fee (Refund Charge)

Kustom supports charging a return fee when processing refunds in certain markets. However, this feature has the following conditions:

• The order must be fully captured in a single capture (no partial captures)
• The sum of the refunded order lines must exactly match the refund amount
• Supported markets: Austria, Germany, Denmark, Finland, France, Netherlands, Norway, Sweden

Order Line Handling

When sending order data to Kustom, the following rules apply:

Troubleshooting

Common Issues

Error Handling

Kustom errors are logged and displayed on the order in the Errors section. Check the order details for detailed error messages from Kustom when a payment operation fails.

Supported Operations