2015-10-29 Integrationsguide Version 2.3
INTEGRATIONSGUIDE
Svea Ekonomi /
Webpay
2015-10-29 Integrationsguide Version 2.3
Inledning
För att Svea Ekonomi/Webpay ska kunna garantera en väl fungerade produkt tillsammans med en kvalitetssäkring mot våra partners och kunder har vi tagit fram en integrationsguide med en checklista.
Checklistan innehåller funktionalitet som vi ser att våra partners följer vid en integration mot SveaEkonomi/Webpay. För att nå denna funktionalitet för finansieringslösningarna samt
kort/direktbanksbetalning skall ni integrera mot oss via något av våra integrationspaket. Om detta inte sker måste ni meddela integrationsgruppen om detta.
Integrationspaketen har tagits fram för att underlätta både integrationen och underhållet av kopplingen mot Svea Ekonomi/Webpay.
Obs. De begrepp som anges i detta dokument utgår från Integrationspaketet. Om ni integrerar på annat sätt kan namngivningar och begrepp skilja sig.
Integrationspaket samt teknisk dokumentation finner ni här:
https://github.com/sveawebpay
eller på hemsidan:
http://webpay.svea.com/sv/swe/salja/tech-site/
Svea Ekonomi/Webpay erbjuder möjligheter att bygga in administration av ordrar i webbutikens
administrations-gränssnitt, vilket bidrar till en bättre tjänst. Detta finns beskrivet under rubriken Administration.
För exponering i webbutiken finns flertalet stödfunktioner som gör att säljande bolag kan öka sin konvertering, som genom att exempelvis visa månadskostnader på produktnivå, för den totala varukorgen med mera, vilket är något som starkt efterfrågas av säljande e-handelsföretag. Även hur betalsätten mest effektivt exponeras i kassan finns beskrivet, för bland annat faktura och kampanjer tillsammans med övriga betalsätt. Vi har tagit fram en lista på flera liknande funktioner som efterfrågas och behöver finnas med, vilka finns under rubrikerna Betalmetoder/Betalflöde.
Förslag på förklarande text till svarskoder för tjänsterna som kan presenteras för slutkonsumenten finns under rubriken Svarskoder.
När ni är klara med integrationen
Kontakta Integrationsavdelningen via support-webpay@sveaekonomi.se när ni är klara med integrationen och samtliga checkboxar är ifyllda så att vi kan testa av funktionaliteten. För att kunna göra detta behöver vi tillgång till en konfigurerad testbutik samt inloggning till ert administrationsgränssnitt.
2015-10-29 Integrationsguide Version 2.3
Betalmetoder
Faktura, DelbetalaIntegration för samtliga länder som Svea Ekonomi/Webpay stödjer för tjänsterna Faktura och Delbetala.
Obligatorisk
Sverige, Norge, Finland, Danmark
Vid efterfrågan
Nederländerna, Tyskland
Hämta adress
Vår GetAddresses-funktion implementeras för att tydliggöra för slutkonsumenterna vilken adress varan kommer att levereras till samt säkerställa kundens adressuppgifter, vilket också ökar konverteringsgraden för webshopen. Om man i ett tidigt skede i kassan ber slutkonsumenten välja betalsätt samt fylla i sitt personnummer/organisationsnummer, kan man använda adressen som returneras i svaret från
CreateOrder-anropet till att förifylla/skriva shopens egna adressformulär. För företag, där flera adresser kan finnas registrerade, används funktionen för att presentera val av fakturaadress för slutkunden.
Observera att pga nationella regler gör vi inte GetAddresses för privatpersoner och företag i Finland samt privatpersoner i Norge. Dock behöver personnummer fortfarande samlas in för att skickas med i
orderanropet.
☐ Kontrollera att GetAddresses-funktionen för att hämta adressuppgifter visas i samband med val av betalmetod.
☐ Kontrollera att slutkunden informeras om den faktiska faktura- och leveransadressen, och inte får intrycket av att det går att skriva över med en egen.
Oavsett om GetAddresses-funktionen används eller inte måste den adress som returneras i svaret från
CreateOrder-anropet fångas upp och sparas ner som orderns faktiska faktura- och leveransadress. Om butiken tillåter att kunden anger en annan leveransadress än folkbokföringsadressen så tar inte Svea kreditrisken.
I vissa undantagsfall kan detta vara överenskommet via avtal med Svea, därför skall det gå att ställa om detta i konfigurationen.
☐ Kontrollera att folkbokföringsadressen som skickas med i CreateOrder-anropet fångas upp i svaret och används som leveransadress
Faktura företag alla länder
☐ Erbjud möjlighet att ange kundreferens (max 32 tecken). Dennna referens skall sparas ner med övriga uppgifter och skickas med i orderanropet.
Sverige och Danmark
☐ Val mellan privatperson eller företag för faktura (Delbetala skall endast vara valbart för privatpersoner.)
☐ Ett fält att skriva in personnummer/org.nummer beroende på ovanstående val
☐ En submit-knapp som gör ett GetAddresses-anrop
Norge
☐ Val av privatperson eller företag
☐ Ett fält att skriva in personnummer/org.nummer beroende på ovanstående val
☐ Endast vid val av företag visas en submit-knapp som gör ett GetAddresses-anrop
☐ Kontrollera att GetAddresses-funktion inte visas vid val av privatperson
Finland
☐ Val mellan privatperson och företag
☐ Ett fält att skriva in personnummer/org.nummer beroende på ovanstående val
Nederländerna
☐ Kontrollera att GetAddresses-funktion inte visas
☐ Kontrollera att vi samlar in gatunamn och husnummer för att kunna lägga ordern utöver övriga adressuppgifter
☐ Kontrollera att vi samlar in födelsedatum och initialer för att kunna lägga ordern utöver övriga adressuppgifter
Tyskland
☐ Kontrollera att GetAddresses-funktion inte visas
☐ Kontrollera att vi utöver övriga adressuppgifter samlar in momsregnr (VATnr) och företagsnamn för att kunna lägga ordern
2015-10-29 Integrationsguide Version 2.3
Presentera adressen för slutkonsumenten
När GetAddresses görs skickar Svea en eller flera adresser tillbaka i svarsanropet. Adressen skall användas för att tydligt visa upp för slutkonsumenten att det är denna adress som kommer att gälla som faktura och
leveransadress.
*I vissa undantagsfall kan slutkonsumenten få en separat leveransadress men detta måste avtalas med Svea.
Om flera adresser finns i svaret på anropet (gäller endast företag) skall slutkonsumenter välja en av adresserna genom förslagsvis en dropdownmeny. Det val som slutkonsumenten gör är den adress som skall visas upp som slutgiltig faktura-leveransadress.
”AdressSelector” används som nyckel för val av adress för dessa företagsadresser.”
☐ Kontrollera att slutkunden blir informerad om vilken adress som är den faktiska fakturaadressen (förslagsvis genom att synligt skriva över den registrerade fakturaadressen)
☐ Kontrollera att det går att ställa in så att även leveransadressen skrivs över
☐ Kontrollera att samtliga registrerade adresser visas upp valbara vid GetAdresses för företag
☐ AddressSelector för vald adress skall sparas ner för att användas senare i orderanropet vid köp för företag
Visa och välja delbetalningskampanjer
KampanjerDelbetalningskampanjer presenteras i kassan som ett separat betalsätt. Observera att delbetala endast skall vara valbart för privatperson.
Presentera kampanjerna som ”radio buttons” . Om kampanjen ”Köp nu, betala om 3 månader” finns skall den presenteras som första val.
Köp nu, betala om 3 månader
3 månader utan ränta
6 månader utan ränta
12 månader utan ränta
24 månader räntebärande
På varje kampanj skall pris per månad visas. Priset skall vara inklusive avgifter och rabatter. För att räkna ut månadskostnaderna finns i vårt Integrationspaket en funktion som heter paymentPlanPricePerMonth.
Alla valbara kampanjer skall vara synliga samtidigt
Köp nu, betala om 3 månader
Kampanjen ”Köp nu, betala om 3 månader” kan med fördel presenteras som ett separat betalsätt för t ex.
julkampanj.
☐ Kontrollera att alla kampanjer visas och är valbara
☐ Kontrollera att summan per månad är korrekt och inkluderar alla avgifter
☐ Kontrollera att slutkunden informeras om uppläggningsavgift
☐ Se till att kampanjkod för vald kampanj sparas ner för att skickas med i orderanropet.
2015-10-29 Integrationsguide Version 2.3
Betalflöde
FakturaavgiftDet skall ges möjlighet att ange en fakturaavgift. Observera att detta endast gäller fakturabetalningar.
Obligatorisk
☐ Kontrollera pris per orderrad/produkt/totalt
☐ Tvinga slutkunden med obligatoriska fält för att fånga upp och skicka med mobilnr och e-post samt personnr.
☐ Kontrollera moms per orderrad/produkt/totalt
☐ Kontrollera kvantiteter
☐ Kontrollera fraktkostnad
☐ Kontrollera faktureringsavgift
☐ Kontrollera att flera olika momssatser i en order hanteras
☐ Test av rabattkuponger (coupons), tillgodohavanden (vouchers) m.m. så att summor, moms stämmer m. Svea
☐ Kontrollera att utökade tecken (t.ex. åäö) i orderrader, produktbeskrivningar m. m kommer in korrekt till Svea
☐ Fångar upp och sparar ner SveaOrderId från svaret
☐ Fångar upp och sparar ner CustomerIdentity från svaret som fakturaadress för orderhistorik för att förhindra fraud
☐ Skickar med IP-adress från slutkunden till Svea
☐ Kontrollera att det går att välja hur fakturan skall levereras i konfigurationen via Post eller E-post*.
Vid efterfrågan*
☐ Valbart för slutkunden att välja levereanssätt av fakturan via Post eller E-post i webshoppen
Kort och Direktbank
Direktbanksbetalningar som t.ex. SEB, Nordea, Handelsbanken, Swedbank skall presenteras valbara i kassan.
Kundens registrerade direktbanksmetoder går att hämta med funktionen getPaymentMethods så att de kan presenteras med respektive banks logotyper som val.
Kortbetalning skall visas som ett betalsätt tillsammans med logotyper för exempelvis ”Visa/Mastercard”,
”American Express”. Vilka logotyper som skall visas i kassan bör vara konfigurerbara då kunderna kan ha avtal för flera olika kort.
Köp - Avslag
☐ Kommer man tillbaka till kassan i webbshoppen från Kortbetalsidan/banksidan med ett felmeddelande
Obligatorisk
☐ Kontrollera pris per orderrad/produkt/totalt
☐ Kontrollera moms per orderrad/produkt/totalt
☐ Kontrollera kvantiteter
☐ Kontrollera fraktkostnad
☐ Test av rabattkuponger (coupons), tillgodohavanden (vouchers) m.m. så att summor, moms stämmer m. Svea
☐ Kontrollera att utökade tecken (t.ex. åäö) i orderrader, produktbeskrivningar m. m kommer in korrekt till Svea
☐ Fångar upp och sparar ner Transaktions id från svaret
☐ Kontrollera att ReturnUrl skickas med i anropet dit slutkunden skall redirectas vid lyckat/misslyckat köp
☐ Kontrollera att CallbackUrl skickas med i anropet
Vid efterfrågan
☐ Återkommande kortbetalning (Recurring Payments)
2015-10-29 Integrationsguide Version 2.3
Adminfunktioner i webshopen
Om möjligheten finns skall administrering av ordrar byggas in i shopens backend. Följande funktionalitet för respektive betalsätt.
Faktura
☐ Leverera order
☐ Delleverera order
☐ Cancellera order
☐ Kreditera faktura
☐ Delkreditera faktura
Delbetala
☐ Leverera order
☐ Cancellera order
Kort
☐ Leverera / confirm
☐ Cancellera / annul
☐ Kreditera
☐ Delkreditera
Direktbank
☐ Kreditera
☐ Delkreditera
Svarskoder
Förslag på översättning till slutkund på felkoder
Faktura & Delbetala
$_['response_30000-30003'] = "Ert köp kunde tyvärr inte genomföras då kreditkontrollen avslogs. Vänligen försök med en annan betalmetod.";
$_['response_40000-40005'] = "Vi kunde tyvärr inte hitta era kunduppgifter. Vänligen kontrollera angivna uppgifter och försök genomföra ert köp igen.”;
Invoice & Installments
$_['response_30000-30003'] = "Unfortunately your purchase could not be carried out since the credit check was rejected. Please try again with another payment method. ";
$_['response_40000-40005'] = "Unfortunately we could not find your customer information.
Please check the entered data and try to make a purchase again.";