MobilePay PoS

Introduction

Authentication

Detecting MobilePay

User Activation

Notification Service

Payment Flows

Payment Flow

Prepared Payment Flow

Payment Flow Error Handling

Refunds

Cancel Flows

Partial Capture

PoS Management

Notification Service

Best Practices

API Principles

Security Model

Client Versioning

API Responses

Error Handling

Call Throttling

Self Certification

API Errors

Input and Output Formats

Create QR Codes

Changes in V10

Release notes

Glossary

Glossary of Terms

Term Description
Client Client and terminal are used interchangeably for the application that calls the MobilePay PoS API. Client is often used when only discussing the software.
Terminal Terminal and client are used interchangeably for the application that calls the MobilePay PoS API. Terminal refers to the setup where the application is running on a dedicated payment terminal.
Customer The customer is the user who wants to pay for goods and services with MobilePay.
ECR The electronic cash register is an application running on hardware in a shop. The ECR is an application that calls the MobilePay PoS client.
Integrator The company that develops the client and calls the MobilePay PoS API on behalf of the merchant. Sometimes the merchant acts as integrator. Used interchangeably with PoS vendor.
Merchant The merchant is the company that wants to receive payments for goods and services from MobliePay users.
Payment A payment request from the merchant.
Prepared payment A payment request from the merchant, where the merchant has the opportunity, to provide information to the user and/or to receive information about the user, before providing the final amount.
Reservation A reservation is a pre-authorization which guarantees that the user has sufficient funds to pay for the given transaction.
Capture Capture is the process by which payments are secured once the payment has been authorized, i.e. a reservation has been made.
PoS In common language a point-of-sale might mean an Electronic Cash Register. In MobilePay PoS, a point-of-sale is an abstraction that describes a place where a payment can occur and therefore NOT a synonym for ECR. The distinction is subtle but important.
Check-in Customer action performed in order to initiate payment. This could be scanning a QR code or connecting to a terminal.
PoS vendor The company that develops the client and calls the MobilePay PoS API on behalf of the merchant. Sometimes the merchant acts as vendor. Used interchangeably with integrator.
VAT-number In Denmark, this is the CVR-number. In Finland, this is the Y-tunnus. Both refer to the official business ID.