INTEGRATIONSGUIDE Svea Ekonomi / Webpay
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.
Betalmetoder Faktura, Delbetala Integration 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
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 Kampanjer Delbetalningskampanjer 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.
Betalflöde Fakturaavgift Det 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)
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.";