Konfigurera QuickPay

QuickPay är en av de mest populära danska betalningsgatewayerna och används av tusentals webbutiker. Shoporama har en djup integration med QuickPay, som stöder de flesta betalningsmetoder, abonnemang, capture, återbetalningar och mycket mer.

Skapa ett QuickPay-konto

1. Gå till quickpay.net och skapa ett konto
2. Du måste också ha ett inlösningsavtal med t.ex. Clearhaus för att kunna ta emot kortbetalningar
3. Koppla din inlösare i QuickPay under Inställningar » Inlösare

Hitta dina nycklar i QuickPay

Du behöver två nycklar från QuickPay:

1. Logga in på QuickPay Manager och gå till Inställningar » Integration. Båda nycklarna finns på den sidan
2. Privat nyckel. Klicka på Privat nyckel bredvid ditt konto, det vill säga den översta raden med ditt merchant-ID
3. API-nyckel. Klicka på Api key bredvid användaren API user

Inställningar i Shoporama

1. Logga in på Shoporama och gå till Integrationer » Betalningsgateways
2. Klicka på Skapa ny betalningsgateway och välj QuickPay
3. Ge din betalningsgateway ett namn, t.ex. ”Kortbetalning” eller ”MobilePay”
4. Klicka på Spara

Konfiguration

Fyll i följande fält:

• Privatnyckel. Din privata nyckel från QuickPay (används för att verifiera callbacks)
• API-nyckel. Din API-användarnyckel från QuickPay (används för capture, återbetalning m.m.)
• Betalningsmetoder. En kommaseparerad lista över metoder, t.ex. creditcard, mobilepay, apple-pay, klarna-payments m.fl. Se QuickPays lista över betalningsmetoder
• Språk. Språket på betalningssidan, t.ex. da för danska eller en för engelska
• Branding. Valfritt branding-ID från QuickPay, om du har skapat ett branding-tema
• Text på kontoutdrag. Text som visas på kundens kontoutdrag (endast Clearhaus, max 22 tecken)

Inställningar

• Dra av automatiskt vid leverans. Beloppet dras av automatiskt när beställningen markeras som skickad eller hämtad
• Lägg till fakturauppgifter. Skickar med orderuppgifter till betalningsfönstret (krävs för Klarna och PayPal)
• Lägg till mobilnummer. Fyller i kundens mobilnummer automatiskt i MobilePay-fönstret
• Hämta kundadress från MobilePay/PayPal. Låter kunden välja adress direkt i MobilePay eller PayPal, så att adressen skickas tillbaka till Shoporama efter betalningen. Observera att inställningen gäller både MobilePay och PayPal samtidigt

Flera betalningsmetoder

Om du vill erbjuda flera betalningsalternativ (t.ex. både kortbetalning och MobilePay) skapar du helt enkelt flera betalningsgateways i Shoporama, en för varje typ. Alla använder samma QuickPay-konto, men med olika betalningsmetoder.

Exempel:

• Gateway 1: ”Kortbetalning” med metoden creditcard
• Gateway 2: ”MobilePay” med metoden mobilepay
• Gateway 3: ”Apple Pay” med metoden apple-pay

PayPal via QuickPay

PayPal håller på att fasa ut sin gamla kassa och flyttar över alla butiker till PayPal Payments (PPCP). Om du tar emot PayPal via QuickPay behöver du inte byta till en ny betalningsgateway i Shoporama. Uppgradera istället själva avtalet hos QuickPay, så att betalningarna i framtiden dirigeras via PPCP. PayPal-kunder är ofta lojala återkommande kunder med högre genomsnittlig varukorgsvärde, så en inaktiverad PayPal-knapp innebär förlorad omsättning redan från dag ett. Byte är en uppgift med fast deadline.

Så här kommer du igång

1. Logga in på QuickPay Manager och skapa ett PayPal Payments-avtal under inställningarna för inlösare (acquirers). Följ QuickPays egna anvisningar på skärmen.
2. PayPal måste godkänna avtalet innan det aktiveras. Kontakta PayPal om godkännandet drar ut på tiden.
3. I Shoporama skapar du en fristående QuickPay-gateway avsedd för PayPal. Låt ”Betalningsmetoder” stå på exakt ”paypal”. Själva vidarebefordran till PPCP styrs av QuickPay, så det finns inget separat ”ppcp”-värde att ange i Shoporama.
4. Aktivera ”Lägg till fakturauppgifter” på PayPal-gatewayen. Utan denna funktion skickas inga orderrader och adresser med, och PayPal kommer ofta att avvisa betalningen.
5. Aktivera ”Hämta kundadress från MobilePay/PayPal” så att Shoporama får leverans- och fakturaadressen tillbaka från PayPal efter betalningen. Observera att inställningen samtidigt aktiverar adresshämtning för MobilePay.

Välj: Använd PayPal 2.0-format

Inställningen Använd PayPal 2.0-format aktiveras endast om du samtidigt har aktiverat Lägg till fakturauppgifter och endast har PayPal som betalningsmetod i betalningsgatewayen. När den är aktiverad skickar Shoporama inte de enskilda orderraderna till PayPal. Istället drar PayPal endast orderns totala belopp. Detta undviker ett känt fel i PayPals nyare PPCP-integration, där betalningar med rabattkoder eller kuponger avvisas (status 422, ”Rejected by acquirer”), eftersom PayPal inte längre accepterar negativa rabattrader eller en raduppdelning som inte stämmer exakt.

Rekommendation: Om du tar emot PayPal via QuickPay och använder rabattkoder, kuponger eller kampanjrabatter, aktivera då denna inställning. Det är för närvarande det enda sättet att undvika att rabatterade PayPal-beställningar avvisas. Den enda skillnaden är att PayPals kvitto visar orderns totala belopp istället för de enskilda varoraderna. Själva ordern i Shoporama är oförändrad med fullständig varespecifikation.

Checklista när du byter från äldre PayPal till PPCP

• PayPal Payments-avtalet har skapats i QuickPay och godkänts av PayPal.
• PayPal har skapats som en fristående QuickPay-gateway i Shoporama med PayPal som enda betalningsmetod.
• Lägg till fakturauppgifter och hämta kundadress från MobilePay/PayPal är aktiverat.
• Gör en riktig minimibetalning med ditt eget PayPal-login (inte bara sandbox) och bekräfta att beställningen hamnar korrekt i Shoporama, inklusive adress från PayPal.
• Återbetala testbetalningen från beställningen och kontrollera att återbetalningen går igenom hos PayPal.
• Kontrollera att orderbekräftelsemejlet visar PayPal som betalningsmetod.
• Kontrollera att transaktionen bokförs korrekt i e-conomic, Dinero eller Billy, om du använder en bokföringsintegration.
• Testa hela flödet på mobilen. Det är vanligtvis där som PayPal-konverteringen är som högst.
• Inaktivera den gamla PayPal-integrationen först när den nya har bekräftats som aktiv.

3D Secure

Om du vill aktivera 3D Secure lägger du till ”3d-” framför betalningsmetoden. Du ändrar till exempel ”creditcard” till ”3d-creditcard”. 3D Secure är ett krav från de flesta kortutfärdare och minskar risken för bedrägerier.

Funktioner som stöds

• Kortbetalning. Visa, Mastercard, Dankort, JCB, Diners och flera
• MobilePay. Inkl. MobilePay Checkout med adresshämtning
• Apple Pay. Kräver aktivering i QuickPay och Clearhaus
• PayPal Payments (PPCP). Den nya PayPal-lösningen som dirigeras via QuickPay
• Klarna. Kräver att fakturauppgifter skickas med
• Betalningslänkar. Skicka betalningslänkar till kunder från ordersidan
• Capture. Dra in betalningen manuellt eller automatiskt vid leverans
• Återbetalning. Återbetala helt eller delvis direkt från Shoporama
• Cancel. Avbryt en betalning som ännu inte har debiterats
• Prenumerationer. Stöder återkommande betalningar
• REST API. Skapa betalningslänkar via Shoporamas REST API

Säkerhet

Alla callbacks från QuickPay verifieras med en kontrollsumma baserad på din privata nyckel. Beloppet i callbacken jämförs med orderbeloppet, så att det inte går att fuska med betalda belopp.

Kunderna får meddelandet ”Ett fel uppstod” istället för betalningsfönstret

Om kunden skickas till en sida med texten ”Ett fel uppstod” när de klickar på betalningsknappen, klicka då på klockan högst upp i Shoporama-admin och öppna Meddelanden. Om det finns ett meddelande från QuickPay om att API-nyckeln inte har behörighet att skapa betalningsfönstret, använder din betalningsgateway nyckeln från användaren av betalningsfönstret.

Så här åtgärdar du det:

1. Logga in på QuickPay Manager och gå till Inställningar » Integration
2. Klicka på API-nyckel bredvid API-användare och kopiera nyckeln
3. Infoga den i fältet API-nyckel på din QuickPay-gateway i Shoporama och spara
4. Lägg en testbeställning i butiken och kontrollera att betalningsfönstret nu öppnas

Felet uppstår vanligtvis redan vid den första betalningen i en ny butik, eftersom användaren av betalningsfönstret på nyare QuickPay-konton inte längre får skapa betalningsfönster. Beställningarna skapas i Shoporama under tiden och visas som obetalda, så när nyckeln har korrigerats kan du skicka en betalningslänk till de berörda kunderna från beställningssidan.

Vanliga frågor

Ska jag använda nyckeln från ”API user” eller ”Payment Window”?

Använd alltid API-användaren. Båda nycklarna finns under Inställningar » Integration i QuickPay Manager, och de ser likadana ut, men Payment Window-användaren har på nyare QuickPay-konton inte behörighet att skapa betalningsfönster. Om du använder den kan Shoporama visserligen skapa själva betalningen, men kunden kommer aldrig fram till betalningssidan. Nyckeln från API-användare fungerar på både nya och gamla konton, och den används även för att ta ut och återbetala belopp.

Kommer PayPal att sluta fungera i min butik om jag inte gör något?

Ja, så småningom. PayPal fasar ut den gamla kassan. Om du tar emot PayPal via QuickPay ser QuickPay till att flytta över dig till PayPal Payments (PPCP). Du måste själv kontakta QuickPay och bekräfta att avtalet uppgraderas. I själva Shoporama-admin behöver du inte ändra något i den nuvarande inställningen.

Hur vet jag om vi redan har bytt till PPCP?

Logga in på quickpay.net och gå till inställningarna för inlösare (acquirers). Här kan du se om PayPal-avtalet står som PayPal Payments (det nya) eller en äldre version. Om du är osäker, kontakta QuickPay-supporten. Kunden märker ingen skillnad i kassan, så du kan inte se det utifrån i webbutiken.

Måste jag ändra fältet ”Betalningsmetoder” till paypal, ppcp eller liknande?

Nej. Låt fältet stå på exakt ”paypal”. Det finns inget ”ppcp”-värde i Shoporama. Vidarebefordringen till PPCP styrs helt på QuickPay-sidan så snart ditt PayPal Payments-avtal har aktiverats. Du behöver alltså inte ändra något i fältet.

Vad innebär egentligen ”Använd PayPal 2.0-format”, och ska jag aktivera det?

Inställningen styr hur beställningen skickas till PayPal. När den är aktiverad skickar Shoporama inte med de enskilda varuraderna, och PayPal drar endast av beställningens totala belopp. Detta är nödvändigt eftersom PayPals nyare PPCP-integration avvisar betalningar med rabattkoder eller kuponger om en raduppdelning skickas med (PayPal tillåter inte längre negativa rabattposter). Den är endast aktiv om ”Lägg till fakturauppgifter” är aktiverat OCH du endast har PayPal som betalningsmetod i betalningsgatewayen. Rekommendation: Om du använder rabattkoder eller presentkort på dina PayPal-beställningar bör du aktivera den.

Kan jag kombinera PayPal med kortbetalning i samma QuickPay-gateway?

Gör inte det. Skapa en separat QuickPay-gateway för PayPal med PayPal som enda betalningsmetod. Om du blandar ihop dem hanteras rabatter för PayPal inte korrekt och du riskerar att betalningar avvisas. Det är också enklare att felsöka när PayPal står för sig själv.

Påverkar övergången till PPCP min bokföring eller momsbehandling?

Nej. Pengaflödet är detsamma som tidigare: QuickPay avräknar sammanlagt med din webbutik, inte direkt med PayPal. Moms, kontoplan och bokföring förändras inte. Om du använder e-conomic, Dinero eller Billy bokförs ordern automatiskt som tidigare. Övergången är rent teknisk.

Ser kunden något annorlunda i kassan efter övergången?

Nej, inte i själva Shoporama-kassan. Kunden väljer PayPal precis som tidigare och ser samma PayPal-knapp. Skillnaden uppstår på PayPals sida, där kunden nu kan se fler betalningsalternativ via PayPals ”smart payment buttons”. Detta hanteras av QuickPay och PayPal, så du behöver inte uppdatera något i temat eller marknadsföringen.

Vad gör jag om en kund rapporterar att PayPal inte fungerar?

Kontrollera först orderlistan i Shoporama-admin för att se om det finns misslyckade beställningar från den kunden. Gör sedan en testbetalning på ett litet belopp med ditt eget PayPal-konto och återbetala den efteråt. Om testet fungerar ligger felet troligen hos kunden. Om även testet misslyckas, skriv till support@shoporama.dk med ordernummer och felmeddelande.

Hjälp

Om du behöver hjälp med inställningarna är du välkommen att kontakta oss på support@shoporama.dk.