Pay with Smartum in Mobility

(TP55389)

This feature is currently in a test phase and is not yet available to configure and start using. This documentation will be updated when it is ready to activate.

1 Purpose
2 Prerequisites
3 Configuration
- 3.1 Settings
4 Limit which products that can be paid using Smartum
5 Payment Flow

Purpose

For users to be able to pay with Smartum in the web and app.

Prerequisites

To recieve payments through Smartum, you need to:

Join the Smartum network (read more here).

Configuration

Settings

Setting	Description

Setting	Description
smartumUrl	Root URL of Smartum API. (Production env: https://api.smartum.fi) Same for all customers.
smartumApiPublicKey	JWT public key from Smartum API JWT public keys Same for all customers.
smartumClientId	Authorization client ID provided by Smartum. Customer needs to contact Smartum to get this ID. Customer specific.
smartumClientSecret	Authorization client secret provided by Smartum. Customer needs to contact Smartum to get this Secret. Customer specific.
smartumVenueId	The ID of the venue receiving the payment. This can be found under the “Online Payment” section in the Smartum portal. Example: `ven_pDmadXvNHA6XWoew` Customer specific.
smartumBenefitType	Benefit type of Smartum payments. Example: exercise, massage Customer specific.

After that, enable the Smartum Payment Method from Configuration → Payment Method.

Limit which products that can be paid using Smartum

(TP61313)

It is possible to limit which products that can be purchased with Smartum. This works by adding a specific product label to the products that users should be able to pay for with Smartum, and then add that product label to the setting below:

Setting	Value

Setting	Value
enablePaymentWithBenefitProviderSmartumForProductsWithThisProductLabel	Select a product label

Payment Flow

Choose Smartum as payment method
The user will be redirected to the Smartum page to complete the payment.
If payment is successful, the user will be redirected back to your website to view the receipt. If the payment is unsuccessful, the user will get an error message and get redirected back to the checkout.