Skip to main content

Check-in API checklist

Integrate all the API endpoints. For examples of requests and responses, see the quick start guide.

If you're new to the platform, see Getting started for information about API keys, product activation, and the test environment.

Checkin API checklistYour comments

Endpoints to integrate

Initiate check-in session
POST:/point-of-sale/v1/loyalty-check-in

Quality assurance

Handle responses

Make sure to handle all responses and states from the payment: CREATED, AUTHORIZED, ABORTED, EXPIRED, TERMINATED and the event CANCELLED, CAPTURED and REFUNDED.

Handle errors

Make sure to log and handle all errors. All integrations should display errors in a way that the users (customers and merchant employees/administrators) can see and understand them.

Include HTTP headers

Send the HTTP headers in all API requests for better tracking and troubleshooting (mandatory for partners and platforms, who must send these headers as part of the checklist approval).

Avoid integration pitfalls

Follow design guidelines

The Vipps MobilePay branding must be according to the design guidelines.

Educate customer support

Make sure your customer support has all the tools and information they need available in your system, through the APIs listed in the first item in this checklist, and that they do not need to visit portal.vippsmobilepay.com for normal work.

Information for partners

Partners, there are additional checklist items for you, as described in Partner checklist.

Partner checklist
Partner checklistYour comments

Accept partner terms and conditions

As a partner, you accept the Partner terms and conditions

Provide technical documentation for merchants

  • How to apply for products (a URL, plain text or PDF is preferred)
  • How to configure and use the solution (a URL, plain text or PDF is preferred)
  • Frequently Asked Questions (FAQs) for merchants (a URL, plain text or PDF is preferred)

Pilot customer

Provide one pilot customer to verify the integration in the production environment (send organization number and name).

Description of integration

Describe how your integration has been set up, with a link to a demo, or provide screenshots (PDF is preferred).

Send your completed checklist to us at developer@vippsmobilepay.com.

Include a video of your payment flow, your Merchant Serial Number, a short description of your solution, and the reference used in your API requests, so we can verify your integration.

We will verify your integration and get back to you as soon as possible. After the checklist is approved, we'll send you the information you need to go live.

Help us improve our documentation

Did you find what you were looking for?