Skip to main content
API docs by Redocly

Vipps MobilePay Loyalty API (1.0.0)

Download OpenAPI specification:Download

URL: https://developer.vippsmobilepay.com License: Proprietary

Loyalty API for merchants and customer experience partners (CXP) to push loyalty program data to the Vipps MobilePay benefits tab.

This is a write-only, event-based API. All updates are sent as typed events to a single endpoint. Each event has an action field that determines the payload schema.

📚 See the API Guide for more information.

Push a loyalty event

Single endpoint for all loyalty program updates. The action field determines which payload schema is expected.

Events are processed asynchronously. A 200 response means the event was accepted and will be processed.

Authorizations:
(bearerAuthapiKeymerchantSerial)
header Parameters
Vipps-System-Name
required
string <= 30 characters
Example: acme-benefits-platform

Name of the integrating system

Vipps-System-Version
required
string <= 30 characters
Example: 3.1.2

Version of the integrating system

Vipps-System-Plugin-Name
required
string <= 30 characters
Example: acme-benefits-connector

Name of plugin/module for the integration

Vipps-System-Plugin-Version
required
string <= 30 characters
Example: 1.0.0

Version of plugin/module for the integration

Request Body schema: application/json
required
eventId
required
string

Unique identifier for this event

timestamp
required
string <date-time>

Timestamp for when the event occurred

action
required
string
required
object (MemberRegisteredPayload)

Responses

Request samples

Content type
application/json
Example
{
  • "eventId": "evt-8a49f7b9-89cb-4e59-9db0-7f2f66a0a151",
  • "timestamp": "2025-01-15T10:00:00Z",
  • "action": "benefits.member.registered",
  • "payload": {
    }
}

Response samples

Content type
application/json
{
  • "status": "accepted",
  • "eventId": "d6703cc8-9e79-415d-ac03-a4dc7f6ab43c"
}