Skip to content

Commit

Permalink
Merge pull request #2379 from SwedbankPay/feature/devp-479_remove_the…
Browse files Browse the repository at this point in the history
…_cake_mix

Feature/devp 479 remove the cake mix
  • Loading branch information
arebra authored Nov 13, 2024
2 parents 4e16dc7 + 75fde0f commit 27f1eb3
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 41 deletions.
3 changes: 2 additions & 1 deletion checkout-v3/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,8 @@ menu_order: 1

There are three ways of implementing our digital payments, depending on what
suits you best. The **native implementation**, which goes directly towards our
APIs, **modules** (WooCommerce) or **SDKs** (.NET or Java).
APIs, **modules** (WooCommerce) or **SDKs** (*.NET* or *Java* for web, *iOS* and
*Android* for mobile apps).

The modules and SDKs have their [own section][modules-sdks], which is where you
need to go if you are planning on using them. A bit less flexible than the
Expand Down
53 changes: 13 additions & 40 deletions checkout-v3/modules-sdks/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,50 +11,14 @@ menu_order: 4
---

Swedbank Pay offers APIs, SDKs, libraries, modules, extensions and plugins as
different ways to integrate and use our products and services. It might not
be obvious to everyone what these are, so to describe them we use the analogy
of **baking a cake**.

### APIs

APIs (Application Programming Interface) are the lowest level building block of
our offering and can be compared to **raw ingredients**. They give you a whole
lot of flexibility, but also requires you to have more knowledge in how to use
them correctly and you need to know which recipe to cook in order to get a
workable cake out in the other end. To efficiently use an API, you need to be
a trained baker.

### SDKs

SDKs (Software Development Kit), also known as libraries, can be compared to
a **cake mix**. It requires less knowledge of the ingredients and how to use
them and a recipe is provided for you. Because of this, you also have less
flexibility because you can't bake any cake, you can only bake the one the mix
is for. You still have to mix everything together, so you need some experience
in the kitchen is required, but less than using the "raw" API.

### Modules

Modules, also known as extensions or plugins, can be compared to a **readily
baked cake** purchased at a bakery. You don't need any baking skills to have
one, but you also have very little flexibility in what goes into the cake or
how it tastes.

## Official Modules
different ways to integrate and use our products and services.

**Modules, extensions and plugins** are typically used as a way to extend
webshop platforms such as [WooCommerce][woocommerce]{:data-proofer-ignore=''}
with functionality that isn't provided in the core platform. Such functionality
may be to allow visitors of your website to pay with a payment provider such as
Swedbank Pay.

{:.table .table-striped}
| Platform | Module | Repository |
| :--------------------------: | :--------------------------------------------------------------- | :-------------------------------------------- |
| ![WooCommerce][woo-icon] | [Swedbank Pay Payment Menu for WooCommerce][woo-checkout-link]{:target="_blank"} | [`…woocommerce-checkout`][woo-checkout-repo]{:target="_blank"} |

## Official SDKs

**Software Development Kits** allow developers to integrate with Swedbank Pay's
APIs without having to write a lot of low-level code dealing with HTTP, status
codes, problem messages, parsing, serializaiton, etc. Developers can use their
Expand All @@ -63,6 +27,18 @@ programming language and environment.

SDKs are often used as a building block to construct a *Module*.

**Software libraries** are bundles of code often used by an *SDK* or in a
*Module* to solve one or a set of specific problems.

## Official Modules

{:.table .table-striped}
| Platform | Module | Repository |
| :--------------------------: | :--------------------------------------------------------------- | :-------------------------------------------- |
| ![WooCommerce][woo-icon] | [Swedbank Pay Payment Menu for WooCommerce][woo-checkout-link]{:target="_blank"} | [`…woocommerce-checkout`][woo-checkout-repo]{:target="_blank"} |

## Official SDKs

{% include alert-unsupported.md type='SDKs' %}

{:.table .table-striped}
Expand All @@ -75,9 +51,6 @@ SDKs are often used as a building block to construct a *Module*.

## Official Libraries

**Software libraries** are bundles of code often used by an *SDK* or in a
*Module* to solve one or a set of specific problems.

{% include alert-unsupported.md type='libraries' %}

{:.table .table-striped}
Expand Down

0 comments on commit 27f1eb3

Please sign in to comment.