Vipps API i WordPress: 5 use-cases + kode 2026

Vipps API lar deg integrere Norges mest brukte betalingsløsning direkte i WordPress, WooCommerce eller en egen applikasjon. I 2026 dekker plattformen ikke bare engangsbetaling, men også login, abonnement, faktura og donasjoner — alt via REST-baserte endepunkter. Denne guiden viser fem konkrete use-cases, kode-eksempler i PHP og JavaScript, og hvordan du raskest kommer i gang.

Hos Nettsmed har vi integrert Vipps API i alt fra små nettbutikker til abonnementstjenester for ideelle organisasjoner. Vi ser at de fleste SMB ikke trenger en custom-implementasjon — den offisielle WooCommerce-pluginen dekker ePayment ut av boksen. Men når du skal koble Vipps mot et CRM, et fakturasystem eller en SaaS-tjeneste, må du gå direkte mot Vipps API.

Hva er Vipps API i 2026?

Vipps API er samlingen av REST-endepunkter Vipps MobilePay tilbyr for å la utviklere og bedrifter integrere Vipps-funksjonalitet i egne systemer. Etter sammenslåingen med danske MobilePay i 2023 ble plattformen samlet under developer.vippsmobilepay.com, og hele API-stacken er nå dokumentert ett sted.

I 2026 består Vipps API av fem hoved-API-er:

• ePayment API — engangsbetaling i nettbutikk og app
• Login API — pålogging med Vipps via OAuth 2.0
• Recurring API — abonnement og månedsbetaling
• Vipps Faktura API — sende fakturaer som Vipps-betaling
• Checkout — ferdig kassaløsning som inkluderer betaling, adresse og frakt

Alle API-er er REST-baserte, returnerer JSON og krever en OAuth 2.0 access token før hvert kall. Denne tokenen henter du fra /accesstoken/get-endepunktet og cacher i 30–55 minutter.

5 konkrete use-cases for Vipps API

Vipps API dekker langt mer enn ren betaling. Her er fem use-cases vi har implementert for kunder de siste 12 månedene.

1. Engangsbetaling i WooCommerce-nettbutikk

Det vanligste bruksområdet. Med ePayment API tar du imot kortbetaling via Vipps på under 30 sekunder for kunden. Vipps API håndterer hele flyten: opprette betaling, redirecte kunden til Vipps-app, motta callback ved fullført transaksjon.

// PHP-eksempel: opprett en betaling
$response = wp_remote_post('https://api.vipps.no/epayment/v1/payments', [
  'headers' => [
    'Authorization' => 'Bearer ' . $access_token,
    'Ocp-Apim-Subscription-Key' => VIPPS_SUBSCRIPTION_KEY,
    'Merchant-Serial-Number' => VIPPS_MSN,
    'Content-Type' => 'application/json',
  ],
  'body' => json_encode([
    'amount' => ['currency' => 'NOK', 'value' => 19900], // 199 kr i øre
    'paymentMethod' => ['type' => 'WALLET'],
    'reference' => 'ordre-' . $order_id,
    'returnUrl' => home_url('/takk'),
    'userFlow' => 'WEB_REDIRECT',
  ]),
]);Code language: PHP (php)

2. Logg inn med Vipps på nettsiden

Vipps Login lar besøkende logge inn med Vipps-appen i stedet for e-post og passord. For B2C-kunder reduserer dette friksjon dramatisk — vi ser konverterings-løft på 15–30 % på registreringssider når Vipps Login er primær login-metode. Vipps API for login bruker standard OAuth 2.0 og krever ingen lagring av passord på din side.

3. Abonnement og månedsbetaling med Recurring API

For SaaS-tjenester, treningsstudio og medlemsklubber er Vipps Recurring API gull verdt. Kunden godkjenner en avtale én gang, og du kan trekke fast beløp månedlig uten ny godkjenning. Vipps API håndterer hele agreement-livssyklusen — opprettelse, oppfølging, kansellering — via tre endepunkter under /recurring/v3/agreements.

4. Vipps Faktura — fra utstedt til betalt på minutter

Vipps Faktura sender en push-notifikasjon til mottakeren med fakturaen direkte i Vipps-appen. For SMB som fakturerer privatpersoner (kursavgifter, tjenester, donasjoner) er dette langt raskere enn KID-faktura via bank — vi ser typisk 70–80 % betalt innen 24 timer mot 30–40 % på vanlig KID. Du kaller Vipps API med fakturadata og mottakerens telefonnummer; resten håndterer Vipps.

5. Innsamling og donasjoner

Ideelle organisasjoner og menigheter bruker Vipps API gjennom Vipps Hurtigkasse eller dedikerte donasjons-knapper. Med ePayment API kan du bygge en egen donasjons-flyt der beløpet er forhåndsutfylt, og kvittering går direkte til regnskapssystemet via webhook.

Vipps API og WordPress: 3 måter å integrere

Hvilken vei du går avhenger av kompleksiteten i prosjektet og hvor mye kontroll du trenger.

A) Offisiell Vipps WooCommerce-plugin

Den raskeste veien. Vipps for WooCommerce er gratis, vedlikeholdes av Vipps selv og dekker ePayment, Login og Checkout. Installer, lim inn API-nøklene fra Vipps-portalen, ferdig. Anbefales for 80 % av nettbutikker. Vil du dypere inn i Vipps-økosystemet, se vår guide om Vipps i WordPress: sømløs innlogging og betaling.

B) Custom integrasjon mot Vipps API i PHP

Når du trenger en betalingsflyt utenfor WooCommerce — f.eks. et kursregistreringsskjema, en donasjonsknapp eller et CRM-system — bygger du direkte mot Vipps API. Du må håndtere access token, idempotency keys og webhook-verifisering selv. Vi har bygget dette for klienter med custom checkout-flyter der WooCommerce ikke passet.

C) Headless / JavaScript-frontend mot Vipps API

For headless-WordPress, Next.js-frontends eller progressive web apps kaller du Vipps API fra en serverless funksjon (aldri direkte fra browseren — API-nøklene må aldri eksponeres). Frontenden får en betalings-URL den redirecter brukeren til.

// JS/Node-eksempel (server-side):
const response = await fetch('https://api.vipps.no/epayment/v1/payments', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Ocp-Apim-Subscription-Key': process.env.VIPPS_KEY,
    'Merchant-Serial-Number': process.env.VIPPS_MSN,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    amount: { currency: 'NOK', value: 19900 },
    paymentMethod: { type: 'WALLET' },
    reference: `ordre-${orderId}`,
    returnUrl: 'https://dinside.no/takk',
    userFlow: 'WEB_REDIRECT',
  }),
});Code language: JavaScript (javascript)

Vipps API kostnader og gebyrer i 2026

Selve Vipps API er gratis å bruke — du betaler kun transaksjonsgebyr per gjennomført betaling. Per mai 2026 ligger gebyrene typisk i området 1,75–2,9 % + et fast øre-beløp per transaksjon, avhengig av avtaletype og volum. Recurring og Faktura har egne prismodeller. Sjekk Vipps’ offisielle prisside for oppdaterte gebyrer for ditt segment.

5 ting å passe på når du bruker Vipps API

1. Idempotency-Key på alle skrivekall. Uten denne risikerer du dobbeltbelastning hvis et nettverkskall feiler og retries.
2. Verifiser webhook-signaturer. Vipps signerer alle callbacks. Uten verifisering kan en angriper sende falske «betalt»-events til ditt system.
3. Cache access token. Tokenen er gyldig ~55 minutter. Hver ny token-request er gratis, men gir unødvendig latency.
4. Test først i test.api.vipps.no. Vipps tilbyr et fullt testmiljø med fiktive telefonnumre. Aldri ta en custom Vipps API-integrasjon live uten å ha kjørt full smoke-test der.
5. Plan for refusjoner. Vipps API støtter delvis og full refusjon, men du må eksponere dette i admin-grensesnittet ditt — ellers ender det som manuelle e-poster til regnskap.

Vipps API FAQ: spørsmål og svar

Kom i gang med Vipps API

For de fleste WooCommerce-nettbutikker er offisiell Vipps-plugin riktig vei. For alt annet — abonnement, custom checkout, headless eller SaaS — bygger du mot Vipps API direkte. Hos Nettsmed har vi integrert Vipps i alt fra små nettbutikker til skreddersydde løsninger for ideelle organisasjoner.

Trenger du sparring på en konkret integrasjon? Ta kontakt — vi gir deg et ærlig estimat innen 24 timer.