Teknisk information om SveaWebPay

Transkript

1 Teknisk information om SveaWebPay Detta dokument beskriver det du behöver veta för att rent teknisk integrera SveaWebPay i din e-butik. För mer information om WebServices med mera finns ytterligare dokument att tillgå vid behov. Innehållsförteckning INTEGRERA SVEAWEBPAY... 2 OLIKA SÄTT ATT INTEGRERA SVEAWEBPAY... 2 FÄRDIGA MODULER... 2 HOSTAD INTEGRATION... 2 WEBSERVICE INTEGRATION... 2 Faktura... 2 Kortfattad beskrivning:... 2 Detaljerad beskrivning:... 3 Delbetalning... 3 Kortfattad beskrivning:... 3 Detaljerad beskrivning:... 4 Att tänka på vid integration... 4 STARTA DIN E-BUTIK... 5 TERMER OCH ORDVAL... 5 KÖPVILLKOR, DISTANSAVTALSLAGEN (2005:57) OCH PUL... 5 Villkorstext för faktura... 5 Villkorstext för Dela upp betalning... 5 PRODUKTINFORMATION... 6 Visa månadskostnad från SveaWebPay... 6 Månadsbeloppet skall ej visas på billigare varor... 6 ORDER... 6 Är momsen korrekt?... 6 Orderbekräftelse... 6 BETALNING/KASSA... 6 Beloppsgräns för delbetalning... 6 Privatperson eller företag... 6 Checkbox... 6 SLUTLIGEN... 6 Är alla krav uppfyllda?... 6 Har du kopplat bort testläget?

2 INTEGRERA SVEAWEBPAY Det första du måste tänka på när du integrerar dig mot SveaWebPay är vilket typ av system/ e-butik som du har. Till en del e-butiksystem har vi färdiga moduler som gör installation/ integration mycket enkel. Kanske har vi redan en färdig integration skriven (en så kallad Modul ) som du kan ladda ner direkt och därmed vara igång med din butikslösning på ett par minuter. Se vidare under rubriken Färdiga moduler, nedan. Har vi ingen färdig modul för just ditt system, rekommenderar vi att du använder dig av det som vi kallar för Hostad integration. Detta är en lite enklare lösning som är snabb att komma igång med och det kan ta allt mellan en timme och en dag beroende på komplexiteten i din e-butik. Skulle du behöva specialanpassningar rekommenderar vi att du använder det som vi kallar för Webservice integration där du integrerar direkt med WebService-anrop mellar ditt och vårt system. Läs mer om de olika sätten att integrera sig mot SveaWebPay i nästa kapitel. OLIKA SÄTT ATT INTEGRERA SVEAWEBPAY FÄRDIGA MODULER Att använda sig av en så kallad modul (även kallad plugin) är det enklaste sättet att komma igång med betalningar via SveaWebPay. Generellt tar det bara minuter innan du kan prova att genomföra det första testköpet i de e-butiksystem, till vilka vi har färdiga moduler. Vi har moduler för bland annat oscommerce och andra freeware-moduler kommer inom kort. Genom Sveas samarbete med andra välkända e-butiksystem på den nordiska marknaden kan du mycket snabbt och enkelt installera SveaWebPay även på dessa system. Se vår hemsida för information om vilka nordiska system som det redan finns Svea-moduler, till. Titta vidare på vår hemsida för en aktuell och komplett lista över färdiga moduler så kan du se om just ditt e-butiksystem finns med bland dessa. Gå in på och klicka vidare enligt anvisningarna på sidan. HOSTAD INTEGRATION Hostad integration är det enklaste och snabbaste sättet att komma igång med betalningar via SveaWebPay. Det innebär att vid betalning så blir köparen överlänkad till en server hos Svea där köparen kan mata in betalnformation. Efter genomförd betalning blir köparen överlänkad tillbaka till webbutiken. Möjliga betalsätt via den hostade lösningen är Fakturabetalning, Delbetalning, Kort (Visa, Mastercard, Amex, Diners) samt Internetbank (Handelbanken, Swedbank, SEB, Nordea) Vidare information om denna betallösning finns att läsa i vårt dokument Hosted Integration Hostad lösning som du kan ladda ner via vår hemsida under fliken Teknik & Support -> Ladda ner filer WEBSERVICE INTEGRATION Möjliga betalsätt via Webservice lösningen är Fakturabetalning och delbetalning. Faktura Integration måste göras i tre olika steg, köp, fakturaskapande, kreditering Kortfattad beskrivning: Steg 1 - köp Anropa metoden CreateOrder när köparen skall genomföra en betalning. Du erhåller ett SveaOrderNummer i retur från denna metod. Steg 2 - fakturaskapande När det är dags att leverera varorna, anropar du Createinvoice med parametern SveaOrderNummer du erhöll från föregående metod, det vill säga CreateOrder. Du erhåller ett InvoiceId i retur från denna metod. 2

3 Steg 3 kreditering Om en köpare vill returnera en vara och du måste återbetala köparen, anropar du Createinvoice, precis på samma sätt som när du skapade fakturan i steg 2, men denna gång skickar du med en extraparameter som heter InvoiceNrToCredit, detta är det InvoiceId som du erhöll när du skapade fakturan i steg2. Detaljerad beskrivning: Steg 1 - köp En köpare lägger ett antal varor i sin kundkorg i e-butiken. Därefter väljer köparen att gå vidare till kassan. I kassan visar du ut dina befintliga betalsätt samt ett nytt Faktura. Efter att köparen valt alternativet faktura, erbjuder du köparen möjlighet att fylla i sitt personnummer samt e- postadress. Efter att köparen har fyllt i personnummer och e-postadress och klickat på knappen köp anropar du vår webservice. Skicka in varuraderna (beskrivning, antal, pris ex moms samt momssatsen) samt även personnumret, e-postadressen och eventuellt ditt eget ordernummer till metoden CreateOrder. Efter ett lyckat köp returnerar denna metod ett id nummer som kallas SveaOrderNummer. Detta id nummer skall du spara (i databas eller annat lämpligt sätt). Denna metod returnerar även personuppgifter samt adressinformation för det personnummer du skickade in. Presentera för köparen adressinformationen du erhöll, då det är enbart till denna adress som varorna får levereras och det är denna adress som pappersfakturan kommer att skickas till. Steg 2 - fakturaskapande I admingränssnittet i webbutiken skall du sedan i din ordervy (där du hanterar ordrar) lägga till en knapp som heter skapa faktura. När butiksinnehavaren (säljaren) klickar på denna knapp skall själva fakturan skapas. Det du gör är att anropa metoden Createinvoice med varuraderna (beskrivning, antal, pris ex moms samt momssatsen) samt även skicka med det SveaOrderNummer som du erhöll från föregående metod, det vill säga CreateOrder (som du har sparat i din databas eller annat lämpligt sätt). Du erhåller ett InvoiceId i retur från denna metod som du skall spara (i databas eller annat lämpligt sätt). En pappersfaktura kommer att skapas nästa dag och skickas direkt ut till köparen. På pappersfakturan kommer det att stå adressinformation, alla varurader, belopp, antal, moms mm. Observera 1: Beloppet som du vill fakturera kan vara lägre än vad själva orderbeloppet var. Detta ger dig möjligheten att t ex delleverera varor eller att enbart skicka faktura på ett antal varor om ett par av dem är slut i lager. Observera 2: Du kan via vårt admingränsnitt själv se hur fakturan ser ut som kommer att skapas för kunden. För att se denna, logga in i admingränssnittet, leta upp den order du är intresserad av att titta på och klicka på förstoringsglaset -bilden. Du ser nu vilka fakturor som är skapad för denna order. För att se hur fakturan ser ut, klicka på förstoringsglaset - bilden bredvid den faktura du vill titta på. Steg 3 - kreditering Om en köpare vill returnera en vara på grund av att den är trasig, eller ångrat sig och du redan har skapat en faktura (Steg 2). Kan du skapa en så kallad kreditering/kreditfaktura. Detta kommer medföra att en pappersfaktura med minusbelopp kommer att skickas ut till köparen. Det du gör är att anropa du Createinvoice, precis på samma sätt som när du skapade fakturan i steg 2, men denna gång skickar du med en extraparameter som heter InvoiceNrToCredit, detta är det InvoiceId som du erhöll när du skapade fakturan i steg2. Delbetalning Integration måste göras i tre olika steg, hämta delbetalningsalternativ, köp, delbetalningsskapande Kortfattad beskrivning: Steg 1 hämta delbetalningsalternativ Anropa metoden GetPaymentPlanOptions när köparen är i kassan för att visa ut delbetalningsalternativ. Du erhåller ett antal så kallade CampainCode i retur från denna metod. Varje CampainCode motsvarar ett delbetalningsalternativ, t ex räntefritt 3 månader, delbetalning 12 månader etc. 3

4 Steg 2 - köp När köparen skall genomföra en delbetalning, anropar du CreatePaymentPlan med parametern Campain du erhöll från föregående metod, det vill säga GetPaymentPlanOptions. Du erhåller ett SveaPaymentPlanNr i retur från denna metod. Steg 3 delbetalningsskapande När det är dags att leverera varorna, anropar du ApprovePaymentPlan med parametern SveaPaymentPlanNr du erhöll från föregående metod, det vill säga CreatePaymentPlan. Du erhåller ett ContractNumber i retur från denna metod. Observera: För krediteringar/återbetalningar för en delbetalning vänligen kontakta din handläggare för manuell rutin. Detaljerad beskrivning: Steg 1 hämta delbetalningsalternativ En köpare lägger ett antal varor i sin kundkorg i webbutiken. Därefter väljer köparen att gå vidare till kassan. I kassan visar du ut dina befintliga betalsätt samt ett nytt Delbetala. Nu vill du dessutom visa ut vilka olika delbetalningsalternativ som köparen skall få möjlighet att välja mellan t ex räntefritt 3 månader, delbetalning 12 månader etc. Det du då gör är att Anropa metoden GePaymentPlanOptions. Du erhåller ett antal så kallade CampainCode i retur från denna metod. Varje CampainCode motsvarar ett delbetalningsalternativ, t ex räntefritt 3 månader, delbetalning 12 månader etc. Du visar ut delbetalningsalternativen för köparen, samt även erbjuder möjlighet att fylla i sitt personnummer samt e-postadress. Steg 2 - köp Efter att köparen har fyllt i personnummer och e-postadress samt angivit vilket delbetalningsalternativ som köparen vill ha och sedan klickat på knappen köp anropar du vår webservice. Du skickar in CampaignCode, varuraderna (beskrivning, antal, pris ex moms samt momssatsen) samt även personnumret, e-postadressen och eventuellt ditt eget ordernummer till metoden CreatePaymentPlan. Efter ett lyckat köp returnerar denna metod ett id nummer som kallat SveaPaymentPlanNr. Detta id nummer skall du spara (i databas eller annat lämpligt sätt). Denna metod returnerar även personuppgifter samt adressinformation för det personnummer du skickade in. Presentera för köparen adressinformationen du erhöll, då det är enbart till denna adress som varorna får levereras och det är denna adress som delbetalningsavtalet kommer att skickas till. Steg 3 delbetalningsskapande I ditt admin-gränsnitt i din webbutik skall du sedan i din ordervy (där du hanterar ordrar) lägga till en knapp som heter skapa delbetalningskontakt. Det du gör är att anropa metoden ApprovePaymentPlan med varuraderna (beskrivning, antal, pris ex moms samt momssatsen) samt även skicka med det SveaPaymentPlanNr som du erhöll från föregående metod, det vill säga CreatePaymentPlan (som du har sparat i din databas eller annat lämpligt sätt). Du erhåller ett ContractNumber i retur från denna metod som du skall spara (i databas eller annat lämpligt sätt). Ett delbetalningskontrakt kommer att bli skapad nästa dag och skickas ut till köparen. På delbetalningskontraktet kommer det att stå adressinformation, alla varurader, belopp, antal, moms mm Observera: För krediteringar/återbetalningar för en delbetalning vänligen kontakta din handläggare, för manuell rutin Att tänka på vid integration Beloppet som du vill fakturera kan vara lägre än vad själva orderbeloppet var. Detta ger dig möjligheten att t ex delleverera varor eller att enbart skicka faktura på ett antal varor om ett par av dem är slut i lager. För krediteringar/återbetalningar för en delbetalning vänligen kontakta din handläggare, för manuell rutin. 4

5 STARTA DIN E-BUTIK Innan du startar e-butiken är det viktigt att du kontrollerar så att allt är klart så dina kunder inte behöver undra eller ringa och fråga. Spar tid och gör köparna nöjda genom att ge tydliga och exakta besked! TERMER OCH ORDVAL Av juridiska skäl heter det alltid Delbetalning hos Svea inte avbetalning, som medför andra juridiska krav. Av juridiska skäl är det också viktigt att det heter Delbetalning med 0 % ränta. Det får inte heta räntefri delbetalning eller räntefri avbetalning. Alltså: Med Svea kan de erbjuda Delbetalning eller Delbetalning med 0 % ränta KÖPVILLKOR, DISTANSAVTALSLAGEN (2005:57) OCH PUL Det är viktigt att du har en webbsida i din webbutik med köpvillkor inklusive regler för öppet köp och returer. Villkorstext för faktura Vid betalning via faktura samarbetar vi med Svea Ekonomi AB. För att handla mot faktura måste du ange ditt personnummer eller organisationsnummer. Förutsättning för att få handla mot faktura är bland annat att du är registrerad i folkbokföringsregistret i Sverige och är över 18 år. Du får inte ha några betalningsanmärkningar. Samtliga fakturor är av Butiksnamn överlåtna till Svea Ekonomi AB. Fakturans betalningsvillkor är 10 dagar. Vid försenad betalning utgår påminnelseavgift med det belopp som är tillåtet enligt lag, f.n. SEK 50:- exkl. moms, samt dröjsmålsränta med 2 % per månad. Vid utebliven betalning överlämnas fakturan till inkasso Villkorstext för Dela upp betalning Svea Ekonomi AB erbjuder Dig att, efter godkänd kreditprövning som sker efter Du fyllt i personuppgifterna i Kassan, teckna ett kontokreditavtal på de villkor som framgår av de allmänna villkoren till bilagt kontoavtal. Ett kontoavtal innebär att Du får en kredit som Du kan använda till inköp hos till Svea anknutna leverantörer. För varje tillfälle Du betalar till Svea så kan Du disponera motsvarande kreditutrymme som Du amorterar för andra inköp under den tid som kontokreditavtalet gäller. Krediterbjudandet gäller det belopp som anges i kontoavtalet. Kredittiden väljer Du genom att kryssa i det alternativ som passar Dig bäst. Du åtar Dig att inom kredittiden återbetala hela krediten. Det innebär att Du varje månad måste betala minst den summa som framgår av det val Du gjort. Självklart kan Du betala mer eller betala hela krediten på en gång utan att detta kostar något extra. Om Du vill utnyttja kontokrediten under kredittiden för andra köp kommer för att krediten skall vara slutbetald inom den avtalade kredittiden den lägsta månadsbetalningen att höjas. Ju kortare kvarvarande kredittid desto högre lägsta månadsbetalning. Vill Du ha kvar samma lägsta månadsbetalning kan Du kontakta Svea på telefon och ansöka om förlängd kredittid. Av datatekniska skäl kommer Svea, om Du utnyttjar kontokrediten för flera inköp att tills vidare fakturera Dig separat för de olika köpen. Självklart slipper Du i så fall att betala för mer än en aviseringsavgift per månad. Om Du inte särskilt meddelar Svea kommer Svea att för Din räkning att betala Ditt inköp hos butiksnamn. Har Du några frågor så kan du ringa för närmare information. Läs mer om allmänna villkoren på: Läs igenom texterna ovan och anpassa dem till de villkor som gäller i din webbshop. Visa också gärna länk till Distansavtalslagen som du hittar hos Konsumentverket: Tips Se till att ni också följer Personuppgiftslagen och informerar om att ni tillämpar den. På så sätt lugnar man oroliga köpare som är rädda att deras information kanske kan spridas. Det finns flera referenser till PUL på webben, men bl.a. hittar du den här: Tips Visa gärna Köpvillkor mm redan på första sidan, så att dina köpare ser dem tydligt. 5

6 PRODUKTINFORMATION Visa månadskostnad från SveaWebPay Om du vill använda den funktion som SveaWebPay tillhandahåller för beräkning av månadskostnaden (rekommenderas!), så hittar du den bland våra API:er och den heter GetPaymentPlanOptions. Se vidare i dokumentationen. Kolla noga att du tydligt visar rätt belopp! Månadsbeloppet skall ej visas på billigare varor Visas månadsbeloppet endast upp på artiklar/artikelsidor som kostar mer än1000 SEK (om ej annat är överenskommet)? ORDER Är momsen korrekt? I Sverige finns ju tre momssatser: 6, 12 och 25 %. I kommunikationen med SveaWebPay skickas momssatsen med varje artikel i varukorgen. Det är mycket viktigt att beloppen i ordersystemet och bokföringen stämmer överens med de som finns på fakturan som SveaWebPay genererar. Kolla detta extra noga! Orderbekräftelse Är rätt betalsätt utskrivet (om ditt system skriver ut det)? Det räcker med Faktura eller Delbetalning. Är rätt telefonnummer med? Butiken ska hänvisa till webbshopens kundtjänst och inte SveaWebPay som endast kan svara på frågor som direkt rör fakturan. BETALNING/KASSA Beloppsgräns för delbetalning Kolla att delbetalningsköp endast erbjuds för varukorgar på minst 1000 SEK, minsta beloppsgräns för att handla mot delbetalning är 1000 SEK. Privatperson eller företag Finns det en begränsning i kassan så att endast privatpersoner kan köpa med delbetalning? SveaWebPay kan endast erbjuda delbetalning till privatpersoner och inte till företag. Enskilda firmor räknas dock som privatpersoner. Checkbox Vid delbetalningsköp måste kunden godkänna våra kontovillkor. Vi rekommenderar att man i närheten av bekräfta köp -knappen lägger in en checkbox samt en text som bekräftar att kunden accepterar kontovillkoren. Kontakta oss för mer information SLUTLIGEN Är alla krav uppfyllda? Har du gått igenom alla punkter ovan och ändrat så att din webbplats följer rekommendationer, krav och riktlinjer? När alla krav är uppfyllda kontakta oss så hjälper vi er att gå igång i produktion. Har du kopplat bort testläget? Butiker är som standard satta i testläge i SveaWebPays system som måste kopplas bort innan du kör igång på riktigt. Kontakta oss när du vill gå igång i produktion. 6