Value-added services

Services are a field on the order, not a new integration.

Gift cards, promotions, tips, receipts and the rest run on the same order and payment you already send. Switch them on for a merchant, and they work in the terminal app out of the box or through the API for partners building their own flow.

II At the moment of payment

Flexibility at the terminal

Each of these works out of the box in the terminal app, or through the API for partners building the same flow into their own POS.

Send to terminal

Move a payment from one terminal to any other registered terminal, or to a payment page.

Example. A SoftPOS payment that fails is finished on a physical terminal, or online.

Split the bill

The order is split on the terminal itself, or the partner builds the same split into its own POS.

Example. A restaurant hands one terminal to a table and each guest pays their part.

Change payment method

The POS starts the payment as card, and the customer picks the method they prefer on the terminal screen. Lock the order to one method when the choice should not be offered.

Example. The customer pays with Klarna or Swish instead of the card the POS started with.

III In code

Start with card, let the customer choose

Every payment method the merchant has switched on is offered on the terminal, so a payment the POS starts as card can be finished with Klarna, Swish or MobilePay. Send lockToPaymentMethods on the order to keep it to the methods you name, or to card alone.

Partners running their own payment screen switch the method on an in-flight payment with the Update Payment Method API.

// Only card on this order, no switching
  "controlFunctions": {
    "lockToPaymentMethods": ["CARD"]
  }

  // Switch an in-flight payment to Klarna
  PUT /payments/:paymentId/update/payment-method
  {
    "paymentMethod": "KLARNA",
    "params": {
      "paymentMethod": "KLARNA",
      "orderId": "838ca7fc6d7de9770b"
    }
  }
IV Run by the merchant

Gift cards and campaigns in the Merchant Portal

Merchants run the services themselves. Gift cards show the cards issued, the outstanding balance and redemptions per month. Campaigns are scheduled per store, with QR scans tracked on the idle screen and the receipt.

Partners see and manage the same from the Partner Portal, for every merchant in their portfolio.