Introduction

Introduction

Avarda Checkout for WooCommerce is a plugin that extends WooCommerce, allowing you to take payments via Avarda.

Avarda Checkout support High-Performance Order Storage (HPOS).

Avarda Checkout does not support the Checkout block i WooCommerce.
You can read more about this here.


Required WooCommerce Settings


  • Make sure that you have enabled pretty permalinks in your WordPress installation. Otherwise callbacks from Avarda back to your store won’t work and orders will not be updated with the correct order status/information.
  • It is recommended to enable guest checkout  (Enable guest checkout setting in WooCommerce > Settings > Checkout). If you don’t allow guest checkout you must check both Automatically generate username from customer email and Automatically generate customer password in WooCommerce > Settings > Accounts setting page.
  • To get the order total to match between WooCommerce and Avarda you need to configure WooCommerce to display prices with 2 decimals. More information about displaying of prices and how it can cause rounding issues can be found in this article.
  • Your checkout page must use the Classic Shortcode block. Avarda Checkout does not support the Checkout block at this point. You can read more about this here.

Configuration


Before you get started you need to make sure you are using the checkout shortcode on your set Checkout Page.
The Checkout block is the default for new WooCommerce installations as of version 8.3. Avarda Checkout for WooCommerce does not yet support this.

Go to Pages → your set Checkout Page and transform the Checkout block to the Classic Shortcode block.

  1. Go to: WooCommerce > Settings > Payments > Avarda Checkout.
  2. Enable Avarda Checkout by checking the Enable Avarda Checkout checkbox.
  3. Title – Enter the title for the payment method displayed in the checkout and order confirmation emails.
  4. Description – Enter the description of the payment method displayed in the checkout page.
  5. Other payment method button text – Customize the Select another payment method button text that is displayed in the checkout if using other payment methods than Avarda Checkout. Leave blank to use the default (and translatable) text.
  6. Testmode  – Tick the checkbox if you make purchases using a test account.
  7. Enable order management – Tick this checkbox if you want to enable automatic order management for the Avarda order.
  8. Debug log – Tick this checkbox to log events for debugging.
  9. Two column checkout layout – Enables a two column checkout

API Credentials Sweden/Norway/Denmark/Finland

  1. Client ID – Client ID, for each country that you have an agreement for, that you receive from Avarda.
  2. Client Secret – Client Secret, for each country that you have an agreement for, that you receive from Avarda.

Order Management


When an order is created in WooCommerce and a reservation number exists in Avarda system, you have the possibility to handle the order management in Avarda directly from WooCommerce. This way you can save time and don’t have to work in both systems simultaneously.

Requirements

To get started with order management in Avarda via your WooCommerce store, you need to activate the Enable order management setting in the payment gateway settings.

Cancel an order

  1. The WooCommerce order status need to be set as Processing.
  2. Go to the order edit screen by navigate to → WooCommerce → Orders and click on the order you want to edit.
  3. In the Order details box there is a selectbox named Status. Change the status to Cancelled.
  4. Click the Update button located at the top right on the screen.
  5. If everything was successful a new order note saying Avarda reservation was successfully cancelled is created.

Manually Cancel an order

You can also manually Activate and Cancel the Avarda order from WooCommerce without changing the order status in WooCommerce.
With this method the WooCommerce order status will remain unchanged after cancelation.

This can be done from the Order actions metabox in the order in WooCommerce.

  1. In the Order actions metabox, chose the action Cancel Avarda order.
  2. Click Update.
  3. If everything was successful a new order note saying Avarda reservation was successfully cancelled is created.

Activate an order

  1. The WooCommerce order status need to be set as Processing.
  2. Go to the order edit screen by navigate to → WooCommerce → Orders and click on the order you want to edit.
  3. In the Order details box there is a selectbox named Status. Change the status to Completed.
  4. Click the Update button located at the top right on the screen.
  5. If everything was successful a new order note saying Avarda reservation was successfully activated is created.

Manually Activate an order

You can also manually Activate and Cancel the Avarda order from WooCommerce without changing the order status in WooCommerce.
With this method the WooCommerce order status will remain unchanged after activation.

This can be done from the Order actions metabox in the order in WooCommerce.

  1. In the Order actions metabox, chose the action Activate Avarda order.
  2. Click Update.
  3. If everything was successful a new order note saying Avarda reservation was successfully activated is created.

Refund an order

Avarda Checkout supports full refunds as well as partial refunds.

  1. The WooCommerce order status need to be set as Completed.
  2. Go to the order edit screen by navigate to → WooCommerce → Orders and click on the order you want to edit.
  3. In the Order items box, press the Refund button.
  4. Here you can choose to refund the full sum for an item (1), part of the sum (2) or shipping (3).
    If you enter a sum manually (2) you also need to enter the correct tax to refund manually, as opposed to when you refund the full sum for an item in which case the tax is automatically calculated. With shipping (3) you need to enter the amount manually, as well as the tax. Not to be confused with the Refund manually button.
  5. Press the Refund via Avarda Checkout button.
  6. If everything was successful a new order note saying Avarda Checkout order was successfully refunded is created.

Disable and enable order synchronization

By default, order synchronization is always enabled. It is however possible to turn off order synchronization between WooCommerce and Avarda via a setting in the Avarda metabox.

When disabled, you can modify the WooCommerce order in any way (e.g., change order status, modify order lines) without effecting the corresponding Avarda order.

When disabled any changes in either system will have to be done manually. You can find the toggle to turn order synchronization on or off when you expand the Advanced section in the Avarda metabox.

View Avarda order object

In the Avarda metabox you have the possibility to view the current Avarda order in JSON format. This can be useful if you need to troubleshoot and order or are in contact with our, or Avardas, support.

You can find the View Avarda order object button when you expand the Advanced section in the Avarda metabox.


Currencies


The plugin itself has no limitations regarding currency.

However, please note that there can be limitations in the agreement you have with Avarda.

When it comes to questions regarding supported currencies you should always talk to your payment provider. The exception is when the plugin in fact do have limitations.

You can read more about this at the Avarda website.


Subscription support


Avarda Checkout is compatible with the WooCommerce Subscriptions extension for handling of recurring payments.

Read more about recurring payments here.


Compatibility with themes & plugins


  • Avarda Checkout uses its own template file for displaying the checkout page and should work with most themes. However, the plugin is only tested with the Storefront theme and we do not guarantee that it will work with other themes. Common situations when errors occur are:
    – Themes/plugins with customized template files for WooCommerce checkout page.
    – Themes/plugins that modifies the checkout into a multi step checkout.

Krokedil and Avarda do not offer help with adapting your theme or plugin within regular support.