1. Få oprettet test-konto hos ePay

For at du kan teste betalingsmodulet til Magento, skal du have oprettet en test-konto hos ePay. Det er gratis at få oprettet en test-konto til din virksomhed, og når konto er oprettet, vil du få tildelt et unikt test-forretningsnummer (merchantnumber) som skal bruges til test.

» Start din bestilling af en test-konto til ePay her

På trin 2 under "evt. kommentar" skal du angive, at du ønsker en test-konto til Magento. Du skal blot se bort fra priser mv. i bestillingsguiden.

Hvis du senere hen ønsker at gå live med betalingsmodulet, så opdaterer ePay din test-konto til en produktionskonto. På den måde slipper du for, at skulle oprette en ny konto til ePay.

2. Installation af ePay betalingsmodulet i Magento

OBS! Inden du går i gang med installationen så husk at lave en backup af dit eksisterende website!

Installationen af ePay modulet til Magento kan ikke være lettere! Der skal ikke downloades nogle filer, der skal ikke uploades filer via FTP, der skal ikke redigeres eksisterende PHP filer eller lignende, som det ofte er tilfældet i open source systemer.

ePay er et modul, der ligger som en PEAR pakke, der kan hentes automatisk inde fra Magento administrationen via Magento Connect http://www.magentocommerce.com/magento-connect. Følgende er en guide til hvordan dette gøres for at installere ePay betalingsmodulet til Magento.

	Først skal du logge ind i din administration placeret på http://dinurl/index.php/admin. Her skal du gå til menuen System -> Magento Connect -> Magento Connect Manager, som vist til venstre.
	For at gå til Magento Connect Manager inde fra Magento administrationen, skal du logge på med din administrator logon. Når du gør dette, vil du få mulighed for at downloade og installere Magento Extenstions i dit system.
	Du skal nu indtaste navnet på den Magento Extension, som du ønsker at installere. Navnet for ePay modulet er magento-community/ePay. Når du har indtastet dette, skal du blot trykke på knappen Install.
	ePay betalingsmodulet installeres nu i Magento. Når installationen er færdig, vil der i bunden stå Procedure Completed..... For at afslutte installationen tryk nu på knappen Return to admin.

3. Aktivering af ePay betalingsmodul i Magento

For at aktivere ePay betalingsmodul, skal du logge ind i din administration til Magento. Når du er logget ind, skal du vælge menuen System -> Configuration. Herefter skal du vælge punktet Payment Methods i menuen til venstre (findes næsten i bunden i gruppen Sales).

	ePay vil her fremkomme i listen over mulige betalingsmetoder til Magento. Det vil se ud som vist på billedet. Hvis ePay | Dit Online Betalingssystem (www.epay.dk) ikke er at finde på listen, så kan det skyldes at cache er aktiveret i Magento. Prøv herfor at tøm cachen eller genstart din webserver (hvis du har mulighed for dette). Caching i Magento kan midlertidig deaktiveres i menuen System -> Cache Management -> All Cache der sættes til Disable.
	Du skal nu aktivere ePay som betalingsmodul. Dette sker under første punkt med navnet Enabled (sættes til YES). Du skal herefter angive dit PBS Merchant Number (forretningsnummer), som du har modtaget af ePay (enten et test- eller produktion merchantnumber). Når du har angivet disse oplysninger, skal du trykke på knappen Save Config (Orange knap i toppen). ePay betalingsmodulet er nu aktivt i Magento. OBS Det er vigtigt, at du aktiverer den nederste indstilling med navn Send Email Order Confirmation. Sker dette ikke, vil der ikke blive afsendt en ordrebekræftelse til kunden (pr. e-mail), når betalingen er gennemført! Under punkt 7 i denne guide, kan du læse mere om, hvordan du indstiller ePay betalingsmodulet.
	Saved CC Husk at deaktivere betalingsformen Saved CC. Denne betalingsform har intet med ePay modulet at gøre og skaber blot forvirring.

BEMÆRK ved integreret layout!
Der er mange der har meldt ind med problemer omkring opgradering fra et ePay modul 1.8.x til det nye modul med mulighed for betaling i eget layout. Til dette er der lavet en opdatering (2.0.x.x), der kan hentes på magento connect.

Hvis I ønsker at benytte betaling i eget layout, er det vigtigt at I deaktiverer indstillingen "System" -> "Configuration" -> "Web" -> "Session Validation Settings" -> "Validate REMOTE_ADDR". Deaktiveres denne indstilling ikke, vil I blive redirected til forsiden når relay-scriptet kaldes. Et screen-shot af denne indstilling vises nedenfor:

4. Test af betalingsmodulet

Hvis du har sat ePay betalingsmodulet til Magento op med et test-forretningsnummer (merchantnumber) fra ePay, kan du let teste om systemet er sat korrekt op.

FØR DU TESTER
Hvis du vælger at kunden betaler via ePay Standard Betalingsvinduet (ikke i eget layout), skal du logge ind på din konto i ePay og aktivere Standard Betalingsvinduet. Dette gør du under menupunktet "Indstillinger" og "Betalingsvinduet".

Hvis du ikke har aktiveret Standard Betalingsvinduet, så vil du blive afvist med en fejlkode 5501.

Hvis du vælger at kunden skal betale gennem en betalingsform i din Magentos eget layout, skal du først sørge for at det domæne, som du tester fra, er opsat inde i ePay. Er dette domæne ikke opsat vil ePay relay scriptet ikke kunne hente HTML-koden fra dit Magento system og præsentere over for kortholderen.

	Du skal blot gennemfører et køb, som enhver kunde vil gøre det på siden. Når du går til checkout, og har valgt ePay betalingsform, vil en side fremkomme som vist på billedet til venstre. Her vil der være en beskrivelse til kunden, om hvordan betalingen vil foregå.
	Når kunden har godkendt sin ordre, vil denne blive sendt videre til en side, hvor ePay Standard Betalingsvinduet åbnes automatisk. Hvis vinduet ikke åbnes automatisk (pga. en popup blocker), vil kunden kunne trykke på en knap for at åbne betalingsvinduet.
	Til venstre vises et eksempel på ePay Standard Betalingsvinduet. Du har selv mulighed for at tilføje jeres eget logo samt virksomhedsoplysninger i toppen af vinduet. Disse indstillinger laver du inde på din konto i ePay under "Indstillinger" og "Betalingssystemet". Kunden kan vælge mellem alle de betalingsformer, som du har koblet på jeres konto i ePay.
	Når kunden har gennemført sin betaling og lukket betalingsvinduet, vil kunden blive sendt til en bekræftelsesside defineret i Magento. Ordreforløbet er nu færdigt for kunden. Ordren er modtaget i butikken, og betalingen er modtaget hos ePay.

5. Information om betalingen i administrationen til Magento

Når ordren findes frem inde i administrationen til Magento, vil der i feltet med navn Payment Information være information omkring betalingen i ePay. Et eksempel på dette er vist til venstre (klik på billedet for at se det i stort format). Her i denne rubrik findes oplysninger som ePay transaktions ID, beløb der er gennemført gennem ePay, valuta kode, betalingsdato, MD5 oplysninger, svindelkontrol, korttype som betalingen er betalt med samt transaktionsgebyr. Derudover findes der også et link, hvor du kan logge ind i din administration til ePay hvor denne betaling kan findes frem og behandles. Betalingen vil i ePay have samme ordrenummer samt transaktionsnummer som angivet på ordren i Magento.

6. Indstillinger til ePay betalingsmodulet i Magento

Det anbefales kraftigt at du nærlæser disse indstillinger.

Følgende er en beskrivelse af de ePay specifikke indstillinger for ePay betalingsmodulet i Magento.

Enabled	Denne indstilling benyttes til at angive om ePay er aktivt eller ej som betalingsform i systemet. Denne skal som standard sættes til Enabled.
Title	Med tittel har du mulighed for at indtaste navnet på betalingsformen, som kunderne ser den som, når de gennemfører et køb.
Order status (Before the payment is made)	Her er det muligt at angive den status, som en ordre skal have, inden ordren betales. Denne indstilling benyttes for at kunne kende forskel på de ordre, der er betalt, og dem der ikke er betalt. Se også indstillingen nedenfor (New order status - when the pyment is made).
New order status (When the payment is made)	Her er det muligt at angive den status, som en ordre skal have, efter ordren er betalt. Denne indstilling benyttes for at kunne kende forskel på de ordre, der er betalt, og dem der ikke er betalt. Se også indstillingen ovenfor (Order status - Before the payment is made).
Sort order	Den rækkefølge som betalingsformen skal præsenteres i blandt de andre betalingsformer.
Payment from applicable countries	Her er det muligt at definere fra hvilke lande folk skal kunne betale med denne betalingsform.
Payment from Specific countries	Hvis denne betalingsform kun må fremkomme over for betalere fra specifikke lande, kan de enkelte lande specificeres her.
Merchantnumber	Dit forretningsnummer modtaget af ePay. Dette finder du under menuen Indstillinger -> Betalingssystemet når du er logget ind i ePay.
Instant Capture	Instant capture (hæv med det samme) benyttes hvis de ordre, der gennemføres i butikken, skal hæves med det samme / automatisk i ePay. Dette er gældende for ordre som kunden modtager med det samme. Dette er f.eks. online services eller lignende, hvor kunden ikke modtager et fysisk produkt med posten. Ved brug af instant capture er det ikke nødvendigt at logge ind i administrationen til ePay og hæve betalingen, da betalingen automatisk bliver hævet med det samme (instant).
Group	I ePay er det muligt at gruppere betalinger i forskellige grupper. Det er endvidere muligt at begrænse adgang for brugere i ePay til specifikke grupper. En gruppe er blot et navn / streng. Ønskes du ikke at anvende gruppering, skal feltet blot være tomt (standard).
MD5 type	For at sikre de data der sendes mellem Magento systemet og ePay, anbefales brugen af MD5. Mere information om MD5 kan findes på http://www.epay.dk/support/docs.asp?solution=6.
MD5 Key	Hvis du aktiverer MD5 i ePay, skal du angive din hemmelige nøgle (den som du også har angivet i din administration til ePay). Det er vigtigt, at du angiver nøglerne nøjagtigt, så de er ens i det 2 systemer. Også med store og små bogstaver!
Auth SMS number	Hvis du ønsker at modtage en SMS, hver gang der bliver gennemført en betaling, kan dette gøres ved blot at udfylde et mobilnummer i auth sms feltet. Ønskes der flere modtagere, sker dette ved blot at separere numrene med semikolon ;. Ønsker du ikke at anvende denne service, så efterlade du feltet tomt. Bemærk denne service er ikke gratis i ePay.
Auth Mail	Lige som med auth sms, er det også muligt at modtage en e-mail hver gang der gennemføres en betaling. Ønskes der flere modtagere, sker dette ved blot at separere numrene med semikolon ; Ønsker du ikke at anvende denne service, så efterlade du feltet tomt.
Integrated layout	Hvis du ønsker at have betalingsdelen integreret på din egen side og ikke benytte ePay Standard Betalingsvinduet, skal du sørge for at sætte denne indstilling til (1).
Window State	Denne indstilling kan kun benyttes, hvis integrated layout er sat til (2): Standard Betalingsvinduet. Windowstate benyttes til at definere, om betalingsvinduet skal ske i samme vindue eller i en pop-up. Som standard anbefales brugen af en pop-up, så kunden hele tiden kan se butikkens layout, der befinder sig bag ved betalingsvinduet.
3D Secure	Denne indstilling benyttes til at definere hvordan 3D Secure skal behandles (standard defineret af VISA og MasterCard). Hvis der vælges 3D is enabled vil 3D Secure være tilgængelig i ePay Betalingsvinduet sammen med de resterende betalingsformer. Vælges der ONLY 3D Secure, vil kun 3D Secure betalingsformer være tilgængelig. Hvis der vælges 3D Secure is NOT enabled, vil 3D Secure betalingsmåder ikke være tilgængelig i ePay Standard Betalingsvinduet.
Customer pays the payment fee	Hvis denne indstilling aktiveres, vil gebyret for betalingen blive pålagt kunden. Dette sker i et ekstra trin inde i ePay Standard Betalingsvinduet, hvor kunden vil blive oplyst hvad gebyret for betalingen er, og skal bekræfte dette.
Add payment fee to the "shipping and handling amount"	Det er I magento ikke muligt at tilføje et ekstra gebyr felt, hvori transaktiosgebyret findes. I stedet er det med denne funktion muligt at pålægge transaktionsgebyret "shipping and handling amount" feltet når kunden har betalt sin faktura. Hvis pålægning af transaktionsgebyret benyttes sammen med det at hæve betalingerne inde fra administrationen til Magento, så skal denne funktion aktiveres. Ellers vil det i Magento ikke være muligt at hæve det fuldet beløb fra kundens faktura.
Enable subscriptions	Hvis denne indstilling aktiveres, vil der sammen med betalingen blive oprettet et abonnement i ePay. Ved brug af dette abonnement, får du løbende mulighed at hæve flere penge fra kundens betalingskort. Dette benyttes normalt til automatisk optankning, løbende betalinger for en månedlig ydelse på en hjemmeside eller lignende. Aktiveres abonnementsbetalinger, vil der i administrationen hos ePay være mulighed for at administrere de oprettede abonnenter. For at anvende abonnementsbetalinger, kræver det, at du har åbnet op for dette på din konto i ePay.
Send Email Order Confirmation	Denne indstilling anbefales at aktiveres. Aktiveres den ikke, vil der normalt ikke blive afsendt en ordrebekræftelse til kunden om at ordren er gennemført pr. email. Men skal i stedet gøres manuelt inde fra administrationen til Magento.
Which logos to show	Her har du mulighed for at vælge hvilke logoer der skal præcenteres over for kunden, når kunden køber i din Magento butik. Listen af logoer indeholder både kortlogoer samt "trusted" logoer. Som standard er alle enabled og du skal her fjerne de logoer, som du enten ikke ønsker at præsentere over for kunden.
Handle stock	Når kunden går til betaling, bliver der først oprettet en ordre, da ordernummeret skal sendes med til ePay. Her bliver lagerantallet normalt talt ned, hvis dette benyttes. Dette skaber dog problemer med lageret, hvis kunden aldrig betaler for ordren, hvor lageret nedtælles uden reelt at blive solgt ud af. Ved at aktivere denne indstillinger (default) vil ePay modulet først nedtælle lagerstatus når kunden har betalt for sin ordre.
Split payment	Om alle betalinger skal behandles som delte betalinger. Via dette er det via ePay administrationen at hæve en betaling over flere gange (når varer til en ordre afsendes til kunden). Læs mere om delte betalinger hos ePay her.
Process payments from within the order administration of Magento	Denne funktion er vigtig, hvis du ønsker at behandle dine betalinger direkte fra ordre adminitrationen i Magento. Ved at aktivere denne funktion, vil du, når du opretter en invoice (faktura) til en ordre, kunne hæve beløbet direkte via ePay, uden at skulle logge ind i administrationen til ePay og gøre det.
Comment	Denne funktion gør det muligt for kunden at indtaste en kommentar til betalingen, når kunden betaler via integreret layout. Denne kommentar vil være at finde på betalingen i ePay. Denne indstilling er kun gyldig ved brug af integreret design.
Cardholder name	Ved at aktivere denne indstilling er det muligt for kunden at indtaste sit navn, samtidig med kunden indtaster sine kortoplysninger. Navnet vil være at finde på betalingen i ePay. Denne indstilling er kun gyldig ved brug af integreret design.
Cardnumber validation	Ved at aktivere denne indstilling vil der blive udføret en simpel javascript validering af kortoplysningerne, når kunden indtaster disse, inden kunden godkender betalingen. Denne funktion gør det mere brugervenligt over for kunden, så kunden straks bliver gjort opmærksom på det, i tilfælde af et forkert tal indtastes i kortnummeret. Denne indstilling er kun gyldig ved brug af integreret design.
Payment options integrated payment form	Normalt er det ikke muligt at gennemføre EWIRE, eDankort, Nordea og Danske Bank betalinger via integreret design. Dog er det nu muligt i Magento sammen med ePay. Her kan de forskellige betalingsformer aktiveres, hvor kortholder vil have mulighed for at skifte blandt dem via en drop down menu. Denne indstilling er kun gyldig ved brug af integreret design.
Display a cancel payment button in the payment form	Ved at aktivere denne indstilling får brugeren mulighed for at trykke på en knap i betalingsformularen, hvor betalingen bliver afbrudt. Brugen vil da blive sendt til indkøbskurven, hvor brugeren kan gennemføre checkout-forløbet igen. Denne indstilling er kun gyldig både ved brug af integreret design samt standard betalingsvinduet.

7. Opsætning af sprog

Som standard er dansk (da_DK) og engelsk (en_US) sprog implementeret til Magento. Dette afsnit beskriver hvordan ePay modulet kan sættes op til andre sprog. I dette tilfælde beskrives hvordan modulet sættes op til tysk.

	Navigere nu til folderen app\locale Hvis folderen ikke findes, så opret folderen de_DE. En fuld liste af navne for sprog kan findes i filen app/etc/config.xml.
	Find filen Mage_Epay.csv, der ligger placeret under app\locale\da_DK Kopiere nu filen app\locale\da_DK\Mage_Epay.csv til folderen app\locale\de_DE.
	Åben nu filen app\locale\de_DE\Mage_Epay.csv Den vil se ud som angivet til venstre. Her ligge de få antal sprog etiketter, der definerer sproget i ePay betalingsmodulet til Magento. Det er kun kolonnen til højre (det markerede område), der må redigeres, for at sproget bliver ændret. Ændres i kolonnen til venstre, vil oversættelsen blot fejle.

Opsætning af Dansk sprog for resten af Magento kan ske gennem Magento Connect. Mere information om dette kan findes på denne side: http://www.magentocommerce.com/extension/363/magento-community-modules--danish-denmark-language-pack.

8. Ændring af betalingsformularens layout

Ofte er det af interesse at tilpasse den side, som præsenterer betalingsformularen - altså den side hvor kunden indtaster sine oplysninger eller åbner standard betalingsvinduet. Det kan være lidt besværligt at tilpasse denne side, men det er dog alligevel muligt.

	Layout af betalingssiden styres af filen: app\design\frontend\default\default\layout\epay.xml Den ser som standard ud som vist ved dette link: epay.standard.txt. Dette giver et layout som vist i dette screen-shot til venstre.
	Ved at ændre denne fil, f.eks. til det indhold, som er defineret i denne fil epay.modified.txt, så kommer siden til at se anderledes ud. Dette giver et layout som vist i dette screen-shot til venstre.

Bemærk! Det kan være en videnskab at konfigurere sidens layout, så den passer præcist til dit behov. Her er det eventuelt en god idé at spørge ude på MagentoCommerce's forum for hjælp.

9. Behandling af betalingerne fra Magento administrationen (remote interface)

Det er med ePay betalingsmodulet muligt at behandle betalingerne direkte fra ordre behandlingen i Magento, uden at skulle logge ind i ePay og behandle betalingerne efterfølgende.

Bemærk! Denne funktion kræver et ePay BUSINESS abonnement.

	For at aktivere behandling af betalingerne fra Magentos administration, skal indstillingen Process payments from within the order administration of Magento aktiveres til Yes / Ja. Behandling af betalingerne fra Magentos administration hedder hos ePay API / Remote interface Bemærk at når denne indstilling aktiveres i Magento skal den IP adresse som Magento systemet befinder sig på opsættes inde i administrationen til ePay. Dette sker under menuen API / Remote Interface -> Adgang.
	Når ordren indlæses i administrationen i Magento, kommunikerer Magento nu med ePay for at udtrække de detaljerede transaktionsoplysninger på transaktionen i ePay. Informationerne som kan ses her: Transaktions status Ordre nummer Indløser Valuta kode Om det er en split betaling Om betalingen er gennemført via 3D secure Eventuelt beskrivelse Eventuelt navnet på kortholderen Hvilket beløb der er autoriseret samt tidspunkt Hvilket beløb der er hævet samt tidspunkt Hvilket beløb der er krediteret samt tidspunkt Eventuelt transaktionsgebyr
	Når en transaktion for en ordre skal hæves, skal der i Magento først oprette en invoice (faktura). Dette sker i muen i toppen, når en ordre gennemses. Her skal der trykkes på knappen Invoice. Hvis ordren blot ønskes annulleret og beløbet skal slettes i ePay, skal der blot trykkes på knappen Cancel. Magento vil her kommunikere med ePay og slette transaktionen.
	Det er nu muligt at rette denne invoice til. I bunden af invoice siden, er det muligt at vælge, om transaktionen skal hæves. Dette sker ved at vælge Capture Online i drop-down menuen og efterfølgende trykke på knappen Capture Online. Magento vil nu kommunikere med ePay og hæve transaktionen.
	De opdaterede transaktionsinformationer vil nu være at se på ordresiden. Her vil der fremgå at beløbet er hævet.
	Kreditering af betalingen skal ske via den oprettede invoice (faktura). Når invoicen vises, vil der i toppen være muligt at trykke på en knap med navn Credit Memo. Her oprettes en kreditnota på den oprettede invoice (faktura).
	En side fremkommer hvor det er muligt at lave en kreditnota (Credit Memo). Her kan beløbet, der skal krediteres, justeres i bunden. For at oprette kreditnota og kreditere beløbet direkte via ePay skal der herefter blot trykkes på knappen Refund
	De opdaterede transaktionsinformationer, direkte udtrukket fra ePay, vil nu være at se på ordresiden.

Bemærk! Det kan være en videnskab at konfigurere sidens layout, så den passer præcist til dit behov. Her er det eventuelt en god idé at spørge ude på MagentoCommerce's forum for hjælp.

10. Brug af uoriginale templates

Hvis du benytter en speciel template (som du måske har downloaded og installeret via uden om Magento Connect), kan du risikere at få en fejl, når du går til checkout.

Dette skyldes din template leder efter ePay filer, som normalt ligger under standard (default) template folderen. Men da din template er installeret uden om standard (default) folderen kan Magento ikke finde filerne.

Dette kan du hurtigt løse ved at kopiere 2 mapper fra standard template (default) og standard skin (default) folderene over i din nye template foldere.

De 2 foldere som du skal kopiere er navngivet som:

skin\frontend\default\default\images\epay og app\design\frontend\default\default\template\epay

Følg de warnings som din Magento skriver til dig, så stierne peger rigtigt.