Checkout v2 – Introduction

Swedbank Pay Checkout allows your customers to be identified by Swedbank Pay, enabling existing Swedbank Pay Checkout users to pay with their favorite payment methods in just a few simple steps.

Prerequisites

To start integrating Swedbank Pay Checkout, you need the following:

HTTPS enabled web server.
Agreement that includes Swedbank Pay Checkout.
Obtained credentials (merchant Access Token) from Swedbank Pay through the Merchant Portal. Please observe that Swedbank Pay Checkout encompass both the consumer and paymentmenu scope.

Introduction

To get started with Swedbank Pay Checkout, you should learn about its different components and how they work together. Swedbank Pay Checkout consists of two related, but disconnected concepts: Checkin and Payment Menu. Checkin identifies the consumer in our Consumer API and Payment Menu authorizes the payment with our Payment Menu API.

The next step is to Capture the payment. You can either capture the total amount, or do a part-capture (as described under After Payment). Connect these steps and you have Swedbank Pay Checkout.

While Checkin is a necessary component to store personal information and access features like storing cards, it is not a mandatory step for the Checkout process to work. If the payer is from a country where we currently don’t support Checkin, or if they opt not to store their data, that’s fine. The Payment Menu can still be used as a guest.

Sequence

Below, you will find sequence diagrams visualizing the sequence of Swedbank Pay Checkout. The parties involved in the sequences are:

Payer refers to the front-end code that runs in the web browser (JavaScript events as well as user interaction).
Merchant refers to the merchant back-end server.
Swedbank Pay refers to the Swedbank Pay API.

Checkin

The first operation in the Checkout process is to identify the payer. This step is called Checkin and is visualized in the below diagram.

rel:view-consumer-identification is a value in one of the operations, sent as a response from Swedbank Pay to the Merchant.
Show Checkin creates and displays the Checkin Seamless View.
Consumer identification is a simplified view of what happens inside the Checkin Seamless View in order to identify the payer.
onConsumerIdentified(consumerProfileRef) is an event that triggers when the consumer has been identified, and delivers the field consumerProfileRef as a reference to be used when creating the Payment Order that will be used to display the Payment Menu.
POST { consumerProfileRef } ensures that the consumerProfileRef is persisted in storage (a database, for example).

When Checkin is completed successfully and the consumerProfileRef is secured, the next operation is to display the Payment Menu and have the payer complete a payment, which is visualized in the sequence diagram below.

Callback

For every change to the Payment Order after its creation, a callback will be made from Swedbank Pay towards the callbackUrl specified in the Payment Order. It is important to listen to these callbacks so in the event that the payer closes the browser window, there are network problems or anything else unexpected happens during the payment process, the status is updated in the merchant system.

Capture

After the payment is completed, you can Capture the payment. Capture should be done after the goods are shipped or if the purchased goods don’t require shipping. Only payment methods that support authorizations will expose the create-paymentorder-capture operation when they can be captured.

This product supports Danish da-DK, English (US) en-US, Finnish fi-FI, Norwegian nb-NO and Swedish sv-SE.