Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions commerce-add-ons/payment-providers/README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
---
description: >-
Learn more about each of the available integrations for implementing payment
providers into your Umbraco Commerce installation.
Learn about the available integrations for implementing payment
providers in your Umbraco Commerce installation.
---

# What are Payment Providers?

Payment providers are essential for your Umbraco Commerce installation when you want to give users and customers to option to pay for your products.
Payment providers are essential for your Umbraco Commerce installation when you want to give users and customers the option to pay for your products.

The [Invoice](invoicing/) and [Zero](zero/) Payment Providers comes with Umbraco Commerce out of the box. Nine pre-built integrations for different providers are available for you to add additional payment options to your site.
By default, Umbraco Commerce includes the [Invoice](invoicing/) and [Zero](zero/) payment providers. You can also explore additional pre-built integrations to expand your payment options.

## Available integrations

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Klarna</strong></td><td><a href="klarna/">klarna</a></td></tr><tr><td align="center"><strong>Mollie</strong></td><td><a href="mollie/">mollie</a></td></tr><tr><td align="center"><strong>Nets</strong></td><td><a href="nets/">nets</a></td></tr><tr><td align="center"><strong>PayPal</strong></td><td><a href="paypal/">paypal</a></td></tr><tr><td align="center"><strong>QuickPay</strong></td><td><a href="quickpay/">quickpay</a></td></tr><tr><td align="center"><strong>Stripe</strong></td><td><a href="stripe/">stripe</a></td></tr><tr><td align="center"><strong>Opayo</strong></td><td><a href="opayo/">opayo</a></td></tr><tr><td align="center"><strong>Worldpay</strong></td><td><a href="worldpay/">worldpay</a></td></tr><tr><td align="center"><strong>Buckaroo</strong></td><td><a href="buckaroo/">buckaroo</a></td></tr></tbody></table>

## Using These Docs

**These docs are aimed at developers and users** who have at least a basic understanding of [Umbraco](https://umbraco.com), as well as Umbraco backoffice principles.
These documents are designed for developers and users with a basic understanding of [Umbraco](https://umbraco.com) and its backoffice principles.
14 changes: 6 additions & 8 deletions commerce-add-ons/payment-providers/buckaroo/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,21 +4,19 @@ description: Getting Started with the Buckaroo payment provider for Umbraco Comm

# Overview

The Buckaroo payment provider adds functionality to capture payments via the [Buckaroo](https://www.buckaroo.eu/) payment gateway. It is a fully featured payment provider allowing full control of the payment flow directly from the Umbraco Commerce backoffice.
The Buckaroo payment provider integrates with the [Buckaroo](https://www.buckaroo.eu/) payment gateway, enabling you to capture payments directly through the Umbraco Commerce backoffice. This fully featured provider gives you full control over the payment flow.

## [Install Buckaroo](../install-payment-providers.md)
Before you begin, ensure that you have an Umbraco website set up and Umbraco Commerce installed. If not, see the [Umbraco Commerce Documentation](https://docs.umbraco.com/umbraco-commerce/) to get started.

## In this Section
## Install Buckaroo

In this section, we will guide you through the key steps necessary to get you started with the Buckaroo payment provider for Umbraco Commerce.

It is assumed that before we begin you already have an Umbraco website configured and Umbraco Commerce installed. If you are not at this stage yet, please read the [core Umbraco Commerce documentation](https://docs.umbraco.com/umbraco-commerce/) to learn how to get started.
To Install the Buckaroo payment provider, see the [Install Payment Providers](../install-payment-providers.md)

## Useful links

Below are a few useful links that might come in handy should you wish to learn more about the provider itself, and the Buckaroo API.
Here are a few useful links to help you learn more about the Buckaroo payment provider and the Buckaroo API:

* [Buckaroo Payment methods Documentation](https://docs.buckaroo.io/docs/payment-methods)
* [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Buckaroo)
* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Buckaroo/issues)
* [Buckaroo checkout information](https://www.buckaroo.eu/large-corporations/solutions/payment-methods)
* [Buckaroo checkout documentation](https://docs.buckaroo.io/docs/payment-methods)
12 changes: 6 additions & 6 deletions commerce-add-ons/payment-providers/buckaroo/release-notes.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
# Release Notes

In this section, we have summarized the changes to Buckaroo Payment Provider for Commerce released in each version. Each version is presented with a link to the [Commerce Buckaroo Payment Provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Buckaroo/issues) showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail.
This section summarizes the changes to the Buckaroo Payment Provider for Umbraco Commerce released in each version. Each version is presented with a link to the [Commerce Buckaroo Payment Provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Buckaroo/issues) showing a list of resolved issues. You can also find direct links to individual issues for more details.

If there are any breaking changes or other issues to be aware of when upgrading they are also noted here.
If there are any breaking changes or issues to be aware of when upgrading, they will also be noted here.

## Release History

In this section, you can find the release notes for each version of Buckaroo Payment Provider for Commerce. For each major version, you can find the details about each release.
This section contains the release notes for each version of the Buckaroo Payment Provider for Umbraco Commerce. For each major version, you can find the details about the specific changes.

#### Version 13.1.0 and above
### Version 13.1.0 and above

* For details of changes for v13.1.0 and above for **Buckaroo Payment Provider for Umbraco Commerce**, refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Buckaroo/releases).&#x20;
* For details of changes in v13.1.0 and above of the **Buckaroo Payment Provider for Umbraco Commerce**, refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Buckaroo/releases).

**Version 13.0.0 (December 13th 2023)**
### Version 13.0.0 (December 13th 2023)

* Initial release.
23 changes: 11 additions & 12 deletions commerce-add-ons/payment-providers/install-payment-providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,29 +4,28 @@ description: >-
implementation.
---

# Install payment providers
# Install Payment Providers

When you need to install a payment provider into your Umbraco Commerce implementation it is done via NuGet.

The installation can be handled in one of two ways as explained below.
You can install a payment provider in one of two ways:

## Install via the NuGet Manager Console

1. Open the NuGet Manage Console.
2. Type in the following command:
1. Open the **NuGet Manager Console**.
2. Enter the following command:

```bash
PM> Install-Package Umbraco.Commerce.PaymentProviders.PROVIDER
Install-Package Umbraco.Commerce.PaymentProviders.PROVIDER
```

Use the table of available[Payment Providers](install-payment-providers.md#available-payment-providers) to ensure you get the correct package name for the provider you want to install.
3. Use the available [Payment Providers](install-payment-providers.md#available-payment-providers) table below to find the correct package name for the provider you want to install.

## Install via the NuGet Package Manager

1. Open the NuGet Package Manager.
2. Search for the Payment Provider you want to install.
3. Ensure the "Browse" tab is selected.
4. Install the package into your solution.
2. Browse for the Payment Provider you want to install.
3. Install the package into your solution.

Alternatively, you can also find and install the NuGet package via the NuGet Package Manager.

Expand All @@ -42,15 +41,15 @@ Alternatively, you can also find and install the NuGet package via the NuGet Pac

## Default Payment Providers

The following payment providers comes with Umbraco Commerce out of the box.
Umbraco Commerce includes the following payment providers by default:

- Invoicing
- Zero

## Upgrading

{% hint style="warning" %}
Before upgrading, it is always advisable to take a complete backup of your site and database.
Before upgrading, always backup your site and database.
{% endhint %}

Umbraco Commerce uses Umbraco Migrations to install all of its features. Upgrades follow the same process as the installation processes detailed above, by installing the latest version over the top of the existing package installation. By using this process the installation will only install new features and features that are missing.
Umbraco Commerce uses Umbraco Migrations to install all of its features. To upgrade, install the latest version over the existing package. This process will add new features and update any missing components.
14 changes: 6 additions & 8 deletions commerce-add-ons/payment-providers/invoicing/README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,15 @@
---
description: Getting Started with the Invoicing payment provider for Umbraco Commerce.
description: >-
Getting Started with the Invoicing payment provider for Umbraco Commerce.
---

# Overview

The Invoicing payment provider is a "pass-through" payment provider that doesn't capture any payment information itself. Instead, it allows orders to go through in an `Authorized` state where it is assumed that payments will be captured manually in an external system. Once captured, orders can then be updated to the `Captured` payment status via the backoffice.
The Invoicing payment provider is a "pass-through" payment provider that doesn't capture payment information directly. It allows orders to be processed in an Authorized state, assuming payments will be handled manually in an external system. Once the payment is captured, the order status can be updated to Captured via the backoffice.

## Install Invoice Payment Provider
Before you begin, ensure that you have an Umbraco website set up and Umbraco Commerce installed. If not, see the [Umbraco Commerce Documentation](https://docs.umbraco.com/umbraco-commerce/) to get started.

By default, Umbraco Commerce includes the Invoice payment method. If the package has been removed from your implementation, see the [Installing Umbraco Commerce](https://docs.umbraco.com/umbraco-commerce/installation/install) article to reinstall it again.
## Install Invoice

## In this Section
By default, Umbraco Commerce includes the Invoice payment method. If the package has been removed from your implementation, see the [Installing Umbraco Commerce](https://docs.umbraco.com/umbraco-commerce/getting-started/install) article to reinstall it again.

In this section, we will guide you through the key steps to get started with the Invoicing payment provider for Umbraco Commerce.

Before beginning, ensure you have an Umbraco website configured and Umbraco Commerce installed. If not, see the [Umbraco Commerce Documentation](https://docs.umbraco.com/umbraco-commerce/) to get started.
37 changes: 21 additions & 16 deletions commerce-add-ons/payment-providers/invoicing/configuring-umbraco.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
title: Configuring Umbraco
description: >-
Learn how to configure the Umbraco backoffice for enabling the use of
Invoicing as a payment method.
Learn how to configure the Umbraco backoffice to enable the Invoicing payment method.
---

# Configure Umbraco
Expand All @@ -11,21 +9,28 @@ This article will give you details about how to configure Umbraco to start using

## Step 1: Create a Payment Method

The following steps are all handled through the Umbraco backoffice.
To create Invoicing as a payment method, follow these steps:

1. Navigate to **Settings > Commerce > Stores > {Store Name} > Payment Methods** section.
2. Select the **Create Payment Method** button to create a new payment method.
3. Choose **Invoicing** from the list of available payment providers.
1. Navigate to **Settings > Stores > {Store Name} > Payment Methods**.
2. Click **Create Payment Method**.
3. Select **Invoicing** from the list of available payment providers.

![The "Create Payment Method" dialog in the Commerce section of the Umbraco CMS backoffice.](../media/invoicing/umbraco\_create\_payment\_method.png)
![Invoicing Payment method in Umbraco Backoffice](../media/invoicing/umbraco-create-payment-method-new.png)

## Step 2: Configure Payment Provider Settings

The following steps are handled within the payment method editor in the Umbraco backoffice.
4. **Enter a Name** for the payment method. For example: *Invoicing*.
5. Enter a value for **SKU**.
6. Click **Save**.

1. Configure the standard payment method settings as required.
2. Configure the Invoice payment provider settings as follows:
## Step 2: Configure Payment Provider Settings

| Name | Description |
| ------------ | ------------------------------------------------------------------------ |
| Continue URL | The URL of the page to navigate to after payment - e.g. `/confirmation/` |
To configure the Invoicing Provider settings, follow these steps:

1. Navigate to **Settings > Stores > {Store Name} > Payment Methods**.
2. Select *Invoicing*.
3. Choose the appropriate **Tax Class** from the dropdown menu.
4. Enter the **Default Pricing**.
5. Enter the URL of the page in the **Continue URL** field where users should be redirected after completing their payment. For example: `https://www.yourwebsite.com/confirmation`.
6. Enable or disable the ability to cancel pending payments directly from the Backoffice.
7. Enable or disable whether users can manually capture payments for authorized transactions through the Backoffice.
8. Choose the countries where the payment method should be available.
9. Click **Save**.
16 changes: 9 additions & 7 deletions commerce-add-ons/payment-providers/klarna/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,22 +4,24 @@ description: Getting Started with the Klarna payment provider for Umbraco Commer

# Overview

In this section, we will guide you through the key steps necessary to get you started with the Klarna payment provider for Umbraco Commerce.
In this section, you will go through the key steps necessary to get started with the Klarna payment provider for Umbraco Commerce.

It is assumed that before we begin you already have an Umbraco website configured and Umbraco Commerce installed. If you are not at this stage yet, please read the [core Umbraco Commerce documentation](https://docs.umbraco.com/umbraco-commerce/) to learn how to get started.
Before you begin, ensure that you have an Umbraco website set up and Umbraco Commerce installed. If not, see the [Umbraco Commerce Documentation](https://docs.umbraco.com/umbraco-commerce/) to get started.

{% hint style="info" %}
This Klarna payment provider is based on Klarna's hosted payment page API and requires you to sign an agreement with their Klarna Payments platform. If you are signed up for their Klarna Checkout platform, your credentials will not work for this provider.
The Klarna payment provider uses Klarna's hosted payment page API. It requires you to sign an agreement with their Klarna Payments platform. If you are signed up for their Klarna Checkout platform, your credentials will not work for this provider.

Please make sure you are signed up with the correct agreement.
Ensure you are signed up with the correct agreement.
{% endhint %}

## [Install Klarna](../install-payment-providers.md)
## Install Klarna

To Install the Klarna payment provider, see the [Install Payment Providers](../install-payment-providers.md) article.

## Useful links

Below are a few useful links that might come in handy should you wish to learn more about the provider itself, and the Klarna API.
Here are a few useful links to help you learn more about the Klarna payment provider and the Klarna API:

* [Klarna developer documentation](https://docs.klarna.com/)
* [Payment provider source code](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna)
* [Payment provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna/issues)
* [Klarna developer documentation](https://developers.klarna.com/)
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
title: Configuring Klarna
description: >-
Learn how to configure Klarna in order to implement the integration with your
Umbraco Commerce installation.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
title: Configuring Umbraco
description: >-
Learn how to configure the Umbraco backoffice for enabling the use of Klarna
as a payment method.
Expand All @@ -9,7 +8,7 @@ description: >-

## Step 1: Create a Payment Method

The following steps are all handled through the Umbraco backoffice.
To create Klarna as a payment method, follow these steps:

1. Navigate to **Settings > Commerce > Stores > {Store Name} > Payment Methods** section.
2. Select the **Create Payment Method** button to create a new payment method.
Expand Down
14 changes: 7 additions & 7 deletions commerce-add-ons/payment-providers/klarna/release-notes.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
# Release Notes

In this section, we have summarized the changes to Klarna Payment Provider for Commerce released in each version. Each version is presented with a link to the [Commerce Klarna Payment Provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna/issues) showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail.
This section summarizes the changes to the Klarna Payment Provider for Umbraco Commerce released in each version. Each version is presented with a link to the [Commerce Klarna Payment Provider issue tracker](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna/issues) showing a list of resolved issues. You can also find direct links to individual issues for more details.

If there are any breaking changes or other issues to be aware of when upgrading they are also noted here.
If there are any breaking changes or issues to be aware of when upgrading, they will also be noted here.

## Release History

In this section, you can find the release notes for each version of Klarna Payment Provider for Commerce. For each major version, you can find the details about each release.
This section contains the release notes for each version of the Klarna Payment Provider for Umbraco Commerce. For each major version, you can find the details about the specific changes.

#### Version 12 and above
### Version 12 and above

* For details of changes for v12 and above for **Klarna Payment Provider for Umbraco Commerce**, refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna/releases).&#x20;
* For details of changes in v12 and above of the **Klarna Payment Provider for Umbraco Commerce**, refer to the [Releases section on GitHub](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna/releases).

#### Version [**10.0.1 (January 12th 2024)**](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna/issues?q=label%3Arelease%2F10.0.1+)
### Version [10.0.1 (January 12th 2024)](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna/issues?q=label%3Arelease%2F10.0.1+)

* Fixed Gift Cards not being taken into account ([#3](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna/issues/3))
* Fixed issue with total price adjustments not being taken into acount and so causing bad requests ([#2](https://github.com/umbraco/Umbraco.Commerce.PaymentProviders.Klarna/issues/2))

#### Version 10 **(July 5th 2023)**
### Version 10 (July 5th 2023)

* [Initial product launch](https://umbraco.com/blog/umbraco-commerce-release/).

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading