Vipps-integrasjon i app – betaling, abonnement og innlogging

Brukeren trykker «Betal med Vipps». Appen ber deres backend om å opprette en betaling hos Vipps, og brukeren sendes over til Vipps-appen på samme telefon for å godkjenne beløpet. Deretter sendes brukeren tilbake til appen deres.

Godkjenningen reserverer beløpet. Pengene trekkes først når backend gjør en «capture», og Vipps anbefaler at det skjer når varen sendes eller tjenesten er levert. Etter capture overføres beløpet til deres konto innen to til tre virkedager. Webhooks fra Vipps forteller backend om betalingen ble godkjent, avbrutt eller utløp.

To ting er viktige her. Betalingen må opprettes fra backend, aldri fra appen direkte, fordi API-nøklene skal holdes hemmelige. Og ordrestatus må komme fra backend, ikke fra hva appen tror skjedde. Se backend, API og integrasjoner.

Vipps Recurring lar kunden godkjenne en betalingsavtale én gang i Vipps-appen, og så trekkes beløpet etter avtalen uten kortnummer eller skjemaer. Vipps nevner selv abonnement, donasjoner, strøm, forsikring, parkering og treningsmedlemskap som typiske bruksområder. Kunden ser avtalen i Vipps-appen og får varsel når det trekkes.

For dere betyr det at appen kan selge medlemskap eller løpende tjenester uten at dere håndterer kortdata. Vi bygger avtaleoppsett, trekk, stopp og endring av beløp i backend, med status i adminpanelet. Det passer særlig for treningssentre, klubber og foreninger, se app for treningssenter, idrettslag og foreninger.

Vipps Login gir passordfri innlogging der brukeren bekrefter seg i Vipps-appen, og dere får verifiserte profilopplysninger med brukerens samtykke. Løsningen bygger på OpenID Connect, samme standard som BankID og ID-porten. Terskelen for brukeren er lav, og registreringen går på sekunder.

Vipps Login passer for kundeapper, medlemsapper og nettbutikker der dere trenger en pålitelig identitet, men ikke det høyeste sikkerhetsnivået. Gjelder appen helse, økonomi eller offentlige tjenester, ser vi heller på BankID- og ID-porten-innlogging. Løsningene kan kombineres: Vipps Login til daglig bruk og BankID der loven eller risikoen krever det.

Vipps-avtalen må stå i deres navn. Dere søker om å bli kunde hos Vipps MobilePay på vippsmobilepay.com med organisasjonsnummer og bankkonto, og bestiller produktet dere trenger, for eksempel betaling i app. Produktet kan bestilles mens avtalen behandles. Skal dere selge i flere land, trenger dere en egen avtale per land.

Når bestillingen er inne, opprettes en testsalgsenhet automatisk, og API-nøklene hentes i Vipps' portal for bedrifter. Der gir dere oss tilgang, så slipper dere å sende nøkler på e-post. Vipps' egne transaksjonsgebyrer kommer i tillegg til vår pris og avtales direkte med Vipps.

Første steg er å avklare hvilke API-er appen trenger, hvordan ordre og kvitteringer skal se ut, og hva som skal skje ved feil, for eksempel når brukeren avbryter i Vipps-appen. Har dere ikke laget en kravspesifikasjon for appen ennå, tar vi det som del av en appavklaring.

Så bygger vi backend-delen med betalingsoppretting, capture, refusjon og webhooks, og deretter knappen og flyten i appen. Alt testes i Vipps' testmiljø med den egne testappen og fiktive testbrukere, og betalingskoden gjennomgås før vi bytter til produksjonsnøkler og gjør en ekte betaling på én krone sammen med dere. Til slutt får dere dokumentasjon av flyten, inkludert hva som skjer ved refusjon og avbrutte betalinger.

Vipps-integrasjonen er et rent API og fungerer likt i Flutter, React Native, Swift og Kotlin. Bytter dere apprammeverk senere, beholder dere backend-delen.