Transcript 1 Teknisk information om SveaWebPay Detta dokument beskriver

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? ......................................................................... 6
1
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å www.sveawebpay.se 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 www.sveawebpay.se 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
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 epostadress. 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
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
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 08 - 7352969 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 08 – 7352969 för närmare information.
Läs mer om allmänna villkoren på: http://www.sveawebpay.se/?page=delbetala_allmanavillkor
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:
http://www.konsumentverket.se/mallar/sv/artikel.asp?lngCategoryId=1616&lngArticleId=197
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: http://www.pul.nu/lagtext.html
Tips Visa gärna Köpvillkor mm redan på första sidan, så att dina köpare ser dem tydligt.
5
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