Wirement Vipps: Laravel-pakke for sømløs Vipps-integrasjon
I dagens digitale handelslandskap er det avgjørende for norske utviklere å kunne tilby enkle og trygge betalingsløsninger. Wirement Vipps er en Laravel-pakke som gjør integrasjon med Vipps/MobilePay til en lek, spesielt for utviklere som jobber med moderne Laravel-stakker som Flux UI, Livewire og Filament.
Hva er Vipps?
Vipps er en norsk mobilbetalingsapp som lar brukere sende og motta penger ved å bruke mottakerens telefonnummer i stedet for kontonummer. Lansert i 2015 av DNB, har Vipps raskt blitt Norges dominerende betalingsløsning med 4,2 millioner brukere i Norge (av en totalbefolkning på 5,4 millioner).
I 2022 fusjonerte Vipps med Danmarks MobilePay og Finlands betalingsløsninger for å danne Vipps MobilePay - en av Europas største mobile lommebøker. Selskapet betjener nå over 11 millioner brukere og prosesserer omtrent 900 millioner transaksjoner årlig.
Hvorfor er Vipps så populært?
Vipps gjør det veldig, veldig enkelt å betale og ta betalt. Hver eneste dag jobber de for å forenkle betalinger - Vipps er trygt og gjort på et blunk, akkurat slik det skal være! For forbrukere betyr dette:
- Øyeblikkelige betalinger ved å bruke bare telefonnummer
- Ingen gebyrer for transaksjoner under 5000 NOK
- Integrert sikkerhet med BankID for større beløp
- Gruppeoppgjør og kostnadsfordeling mellom venner
For bedrifter er fordelene like klare: Kunder er mindre tilbøyelige til å forlate betalingsprosessen når de har en rask og enkel måte å betale på, og kunder sier gang på gang at de elsker å betale med Vipps og MobilePay.
Introduksjon til Wirement Vipps
Wirement Vipps er en spesialisert Laravel-pakke utviklet av kwhorne som gjør Vipps-integrasjon enkelt og elegant for moderne Laravel-applikasjoner. Pakken er spesielt designet for å fungere sømløst med:
- Laravel v10-12 - full støtte for de nyeste versjonene
- Flux UI v2 - optimalisert for Laravel Flux-prosjekter
- Livewire - inkluderer ferdiglagde Livewire-komponenter
- Filament v3.3 - med ready-to-use Filament-ressurser
- TailwindCSS v4 - moderne styling
Hovedfunksjoner
Pakken tilbyr en imponerende liste med funksjoner som gjør Vipps-integrasjon til en smertefri opplevelse:
🚀 Enkel oppsett: Minimal konfigurasjon og installasjon 💳 Betalingsopprettelse: Lag Vipps-betalinger med letthet 🔐 Token-håndtering: Automatisk token-oppdatering og caching 📡 Webhook-støtte: Enkel webhook-oppsett med Artisan-kommandoer 🏗️ Laravel-integrasjon: Full støtte for Laravel-økosystemet ⚡ Flux UI-kompatibel: Designet spesielt for Laravel Flux-prosjekter 🔴 Livewire-klar: Inkluderer Livewire-komponenteksempler 📊 Filament-integrasjon: Ferdiglagde Filament-ressurser 🏛️ Moderne arkitektur: Ren, serviceorientert design ⚙️ Omfattende konfigurasjon: Alle alternativer i én konfigurasjonsfil
Installasjon og oppsett
Systemkrav
Pakken krever:
- PHP ^8.1
- Laravel ^10.0||^11.0||^12.0
- GuzzleHttp ^7.0
- Carbon ^2.0||^3.0
Installasjon via Composer
composer require kwhorne/wirement-vipps
Miljøvariabler
Legg til følgende variabler i din .env-fil:
VIPPS_CLIENT_ID=your_client_id
VIPPS_CLIENT_SECRET=your_client_secret
VIPPS_MERCHANT_SERIAL_NUMBER=your_merchant_serial_number
VIPPS_SUBSCRIPTION_KEY=your_subscription_key
VIPPS_CURRENCY=NOK
VIPPS_API_URL=https://apitest.vipps.no # For testing
# VIPPS_API_URL=https://api.vipps.no # For produksjon
VIPPS_RETURN_URL=https://your-site.com/payment/callback
VIPPS_WEBHOOK_ID=your_webhook_id
VIPPS_WEBHOOK_SECRET=your_webhook_secret
Database-migrasjoner
php artisan vendor:publish --tag="wirement-vipps-migrations"
php artisan migrate
Konfigurasjon
php artisan vendor:publish --tag="wirement-vipps-config"
Webhook-oppsett
Pakken inkluderer en praktisk Artisan-kommando for webhook-oppsett:
php artisan vipps:webhook
Denne kommandoen guider deg gjennom webhook-opprettelsesprosessen og gir deg webhook-ID og hemmelighet som du kan legge til i .env-filen.
Praktisk bruk
Grunnleggende betalingsopprettelse
Den enkleste måten å opprette en Vipps-betaling på:
use Wirement\Vipps\Services\PaymentService;
// Opprett en betaling ved hjelp av tjenesten
$paymentService = new PaymentService();
$paymentUrl = $paymentService->generatePaymentLink(
10000, // Beløp i øre (100 NOK)
'order-123' // Faktura-/ordrenummer
);
// Omdiriger bruker til betalings-URL
return redirect()->to($paymentUrl);
Avansert bruk med orderlinjer
For mer detaljerte betalinger med spesifikke produktlinjer:
use Wirement\Vipps\Services\PaymentService;
$orderlines = [
[
'id' => '1',
'name' => 'Produktnavn',
'quantity' => 1,
'price' => 100, // Pris i NOK
'vat' => 0.25, // 25% MVA
],
];
$paymentService = new PaymentService();
$paymentUrl = $paymentService->generatePaymentLink(
10000, // Beløp i øre
'order-123', // Fakturanummer
$orderlines // Valgfrie orderlinjer
);
Livewire-integrasjon
For Livewire-komponenter er integrasjonen like elegant:
use Livewire\Component;
use Wirement\Vipps\Services\PaymentService;
class PaymentComponent extends Component
{
public function createPayment()
{
$paymentService = new PaymentService();
$paymentUrl = $paymentService->generatePaymentLink(
5000, // 50 NOK i øre
'order-' . time() // Fakturanummer
);
return redirect()->to($paymentUrl);
}
}
Filament-integrasjon
Pakken gjør det enkelt å integrere Vipps-betalinger direkte i Filament-administrasjonspanelet:
use Filament\Resources\Resource;
use Wirement\Vipps\Services\PaymentService;
// I din Filament-ressurs
Tables\Actions\Action::make('create_payment')
->label('Opprett Vipps-betaling')
->action(function ($record) {
$paymentService = new PaymentService();
$paymentUrl = $paymentService->generatePaymentLink(
$record->total * 100, // Konverter til øre
(string) $record->id // Fakturanummer
);
$record->update(['vipps_url' => $paymentUrl]);
})
Fordeler med Wirement Vipps
For utviklere
Tidsbesparelse: I stedet for å bruke dager eller uker på å implementere Vipps-integrasjon fra bunnen av, kan utviklere komme i gang på minutter.
Moderne arkitektur: Pakken følger Laravel-beste praksis og integreres naturlig med moderne Laravel-stakker.
Omfattende dokumentasjon: Klar og tydelig dokumentasjon med praktiske eksempler.
Webhook-håndtering: Automatisert webhook-oppsett fjerner kompleksiteten ved å håndtere Vipps-tilbakekall.
For bedrifter
Raskere markedsintroduksjon: Redusert utviklingstid betyr raskere lansering av betalingsfunksjoner.
Økt konvertering: Med mindre knot og enkel, rask betaling er det mindre sjanse for at kundene faller av lasset når de skal betale.
Trygg integrasjon: Bygget på Vipps' offisielle API-er med best practice for sikkerhet.
Skalerbarhet: Designet for å håndtere alt fra små webshoper til store enterprise-løsninger.
Fremtidsperspektiver
Med Vipps MobilePay's voksende dominans i det nordiske markedet og deres ekspansjon til resten av Europa, blir pakker som Wirement Vipps stadig mer verdifulle. Vipps MobilePay bygger Europas mest komplette mobile betalingsløsning, som skaper verdi for mennesker og driver momentum for bedrifter på tvers av grenser.
For Laravel-utviklere som jobber med nordiske eller europeiske prosjekter, representerer Wirement Vipps ikke bare en teknisk løsning, men en strategisk fordel i et raskt utviklende betalingslandskap.
Konklusjon
Wirement Vipps fyller et viktig gap i Laravel-økosystemet ved å tilby en sømløs, veldesignet integrasjon med Norges mest populære betalingsløsning. Enten du bygger en enkel webshop eller en kompleks enterprise-applikasjon, gjør denne pakken Vipps-integrasjon til en smertefri opplevelse.
Med sin støtte for moderne Laravel-verktøy som Flux UI, Livewire og Filament, samt sin omfattende dokumentasjon og enkle oppsett, bør Wirement Vipps være førstevalget for enhver Laravel-utvikler som trenger Vipps-funksjonalitet.
Kom i gang i dag: Installer pakken, følg den enkle oppsettsguiden, og gi dine brukere den betalingsopplevelsen de forventer i 2025.
For mer informasjon, besøk GitHub-repositoriet eller utforsk Vipps' offisielle dokumentasjon for utviklere.
