1. Få oprettet test-konto hos ePay

For at du kan teste fakturamodulet til TYPO3, 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 i bestillingsguiden under "evt. kommentar" skal du angive, at du ønsker en test-konto til TYPO3. Du skal blot se bort fra priser mv. i bestillingsguiden.

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

2. Installation af ePay fakturamodulet i TYPO3

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

Først skal du downloade betalingsmodulet.

» Download TYPO3 modulet her

Gem filen et sted på din computer.

	Gå nu til din TYPO3 administration http://dinurl/typo3 og logind. Herefter vælges Ext Manager som vist til venstre.
	I dropdown-menuen vælges Import extenstions. Herefter vælges den downloadede fil i Upload extenstion file directly (.T3X). Tryk på Upload extension file Klik nu på Install extension nederst.
	Sørg her for at ALLE checkboxes er afkrydset. Benyt evt. select/deselect all. Klik på Make updates nederst.

3. Opsætning af ePay fakturamodul i TYPO3

Fakturamodulet er nu installeret, og vi er klar til opsætningen.

	Tryk på knappen ePay i menu til venstre og vælg herefter Settings
	Her angives det merchant number (forretningsnummer), der er modtaget af ePay (enten et test- eller produktion merchant number). Dette angives i feltet Merchant number. Tryk på Save i bunden af siden.
	Tryk nu på Page i menuen til venste og vælg Create new page.
	Fjern krydset i Hide Page og angiv en Pagetitle f.eks. faktura. Gem siden ved at trykke på disketten øverst.
	Vælg nu den nyoprettede side i listen til venstre og tryk på Create page content.
	I bunden af siden vælges General Plugin.
	Tryk på fanebladet Plugin og vælg ePay i dropdown-menuen. Gem ved at trykke på disketten øverst.
	Du skal muligvis også vælge en template til din side. Dette gør du ved at vælge Template og herefter den nyoprettede side. Vælg en template i listen og tryk på Create template for a new site.

4. Test af fakturamodulet

Vi er nu klar til at teste fakturamodulet.

	Start med at gå til forsiden af din TYPO3 og vælg den tidligere oprettede side. Udfyld felterne og tryk på Til betaling
	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 bekræftelsessiden.
	Når betalingen er godkendt vises bekræftelsessiden som vist til venstre.

5. Information om betalingen i administrationen til TYPO3

Når betalingen er gennemført vil denne være tilgængelig i TYPO3 administrationen under ePay Et eksempel på dette er vist til venstre (klik på billedet for at se det i stort format). Ved at klikke på transaktions ID'et vil der vises yderligere oplysninger, om den enkelte betaling.

6. Indstillinger til ePay fakturamodulet i TYPO3

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

Følgende er en beskrivelse af de ePay specifikke indstillinger for ePay fakturamodulet i TYPO3.

Merchant number	Dit forretningsnummer modtaget af ePay. Dette finder du under menuen Indstillinger -> Betalingssystemet, når du er logget ind i ePay.
Use API	Denne funktion er vigtig, hvis du ønsker at behandle dine betalinger direkte fra ordre administrationen i TYPO3. Ved at aktivere denne funktion, vil du, have mulighed for at hæve, slette og kreditere betalinger direkte fra den enkelte ordre i administration for TYPO3. Bemærk! Dette kræver Business Abonnement.
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).
Show E-mail	Sættes til Show, hvis e-mail feltet ønskes vist på betalingssiden.
Show Name	Sættes til Show, hvis navne feltet ønskes vist på betalingssiden.
Show Address	Sættes til Show, hvis adresse feltet ønskes vist på betalingssiden.
Show Country	Sættes til Show, hvis lande feltet ønskes vist på betalingssiden.
Show Phone	Sættes til Show, hvis telefon feltet ønskes vist på betalingssiden.
Show Comment	Sættes til Show, hvis kommentar feltet ønskes vist på betalingssiden.
URL containing terms	Her angives den url, som indeholder betalingsbetingelserne.
Require accept terms	Sættes til Yes, hvis kunden skal acceptere betingelserne før betalingen kan gennemføres.
Available currencies	Her vælges de valutaer, som skal være tilgængelige for kunden at betale i.
Available payment methods	Her har du mulighed for at vælge hvilke logoer der skal præsenteres over for kunden, når kunden betaler i TYPO3.
Company name	Her angives det virksomhedsnavn, som betalingerne sker til.
Company e-mail	Her angives den e-mail adresse, som betalingsbekræftelserne skal sendes fra.
E-mail payment confirmation	Her angives de e-mails, hvortil der skal sendes en kopi af betalingsbekræftelsen.
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 betalingsvinduet, hvor kunden vil blive oplyst hvad gebyret for betalingen er, og skal bekræfte dette.
Instant capture	Instant capture (hæv med det samme) benyttes hvis de ordrer, 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).
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 under "Indstillinger" og "Betalingssystemet"). 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 E-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.
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.
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 Disabled, vil 3D Secure betalingsmåder ikke være tilgængelig i ePay Standard Betalingsvinduet.

7. Opsætning af sprog

Ønsker du at ændre eller tilføje et sprog til ePay fakturamodulet skal du benytte dig af xml-filerne, som befinder jeg således: typo3conf/ext/epay/mod1/locallang_mod.xml
typo3conf/ext/epay/pi1/locallang.xml

8. Behandling af betalingerne fra TYPO3 administrationen (remote interface)

Det er med ePay fakturamodulet muligt at behandle betalingerne direkte fra ordre behandlingen i TYPO3, 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 TYPO3 administration, skal indstillingen Use API være sat til Yes. Behandling af betalingerne fra TYPO3 administration hedder hos ePay API / Remote interface Bemærk at når denne indstilling aktiveres i TYPO3 skal den IP adresse som TYPO3 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 TYPO3, kommunikerer TYPO3 nu med ePay for at udtrække de detaljerede transaktionsoplysninger på transaktionen i ePay. Informationerne som kan ses her: Transaktions status Indløser Valuta kode Om det er en split betaling Eventuel 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
	Når en transaktion for en ordre skal hæves, angives blot det beløb, som ønskes hævet og herefter trykkes der på knappen Capture. Hvis ordren blot ønskes annulleret og beløbet skal slettes i ePay, skal der blot trykkes på knappen Delete. TYPO3 vil her kommunikere med ePay og slette transaktionen. Ønsker du at kreditere et beløb, så angives dette og der trykkes på knappen Credit.

9. Ændring af mail-template

Ønsker du at ændre designet på betalingsbekræftelsesmailen, så gøres det i filen typo3conf/ext/epaymail-template.php Følgende strenge vil blive erstattet: [tid] erstattes med transaktions ID [orderid] erstattes med fakturanummer [cur] erstattes med valuaen [transfee] erstattes med evt. transaktionsgebyr [company] erstattes med virksomhedsnavn [date] erstattes med dato [time] erstattes med tid [cemail] erstattes med kundens e-mail [cname] erstattes med kundens navn [caddress] erstattes med kundens adresse [ccountry] erstattes med kundens land [cphone] erstattes med kundens telefonnummer [ccomment] erstattes med kundens kommentar