Smartum for Developers

Smartum for Developers

  • Docs
  • API

›Design

Design

  • Buttons

Buttons

Always display the generic Smartum button before as the call to action that redirects a user to a Smartum service (e.g., Smartum Checkout).

Button Styles

The Smartum button is customizable so that you can match the look and feel of your application or website.

The button is customizable through URL query string parameters. The base URL for the button is https://badges.smartum.fi/button/{variant}.svg.

Variants

The button comes in three color variants: Smartum's brand color, black, and white. We recommend using the brand color, as it is the most easily identifiable.

VariantButton
colorColor
blackBlack
whiteWhite

The example URL is for the brand color variant is https://badges.smartum.fi/button/color.svg.

Sizes

You can choose the size of the button, with the following restrictions:

  • Minimum width is 120.
  • Minimum height is 30.
  • The minimum ratio between width and height is 4 (width ÷ height ≥ 4).

To specify the size, use the width and height query string parameters.

ParametersButton
width=120&height=30120x30
width=160&height=30160x30
width=200&height=50200x50
width=240&height=50240x50

The example URL for a size of 240x50 is https://badges.smartum.fi/button/color.svg?width=240&height=50.

Corner Radius

If you want a button with rounded corners, you can set the corner radius using the radius query string parameter in the same unit as the size, as long as the value does not exceed half of the height (e.g. for a button height of 50, the corner radius must not exceed 25).

The default corner radius is 0.

ParameterButton
radius=4Radius 4
radius=15Radius 15

The example URL for a corner radius of 4 is https://badges.smartum.fi/button/color.svg?radius=4.

Outline

You may also enable an outline for the button, which is a thin line around it. The outline is controlled through the outline query string parameter that can be set to t (true) or f (false).

By default, there is no outline.

ParameterButton
outline=fNo outline
outline=tOutline

The example URL for an outline is https://badges.smartum.fi/button/white.svg?outline=t.

Guidelines

  1. Do not host the buttons yourself, unless absolutely necessary. Instead, use our own URL when displaying the buttons. This allows us to adjust the buttons over time without requiring you to update them. We guarantee compatibility in terms of adjusted styles.
  2. Do not modify the buttons in any way, other than the ones allowed by the URL parameters.
  3. When showing the Smartum button alongside other buttons, make sure the Smartum button is at least the same size as the others, to be as prominent.
  4. Take advantage of the styling options available to you, and adjust the Smartum button to match the appearance of other visual elements.
  • Button Styles
    • Variants
    • Sizes
    • Corner Radius
    • Outline
  • Guidelines
Docs
Buttons
Resources
API ReferenceSmartum.fi
Copyright © 2025 Smartum Oy