1. Få oprettet test-konto hos ePay

For at du kan teste betalingsmodulet til osCommerce, 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 osCommerce. 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 i ePay.

2. Installation af ePay betalingsmodulet i osCommerce

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 ePay betalingsmodulet her

Gem zip-filen et sted på din computer og udpak indholdet.

Kopier herefter indholdet fra mappen catalog til din eksisterende osCommerce installation og overskriv eksisterende filer.

Bemærk! ePay betalingsmodulet indeholder modificerede versioner af standard osCommerce filer. Hvis du i forvejen har foretaget ændringer i filerne, bør disse flettes med filerne fra ePay modulet. (Dette kræver en form for teknisk indsigt i osCommerce. Du kan læse mere om, hvilke filer det drejer sig om her)

	Først skal du logge ind i din administration placeret på http://dinurl/admin. Her skal du gå til menuen Modules -> Payment, som vist til venstre.
	Klik nu på Credit Card ePay og klik herefter på knappen Install til højre.
	Nu er ePay betalingsmodulet installeret, og dit skærmbillede bør se ud som billedet til venste.

3. Opsætning af ePay betalingsmodul i osCommerce

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

Tryk på knappen Edit for at redigere opsætningen af ePay osCommerce modulet

Under første punkt Enabled vælges, hvorvidt modulet skal være aktiveret. For at aktivere modulet sættes Enabled til true Order status og New order status bruges til at differentiere betalte og ikke-betalte ordre. Det er vigtigt, at der angives en anden værdi end default under henholdsvis Order status og New order status, da de ellers ikke vil blive vist under ordre i osCommerce. Herefter angives det PBS Merchant Number (forretningsnummer), der er modtaget af ePay (enten et test- eller produktion merchantnumber). Dette angives i feltet Merchantnumber. Tryk på knappen Update i bunden af siden.

4. Test af betalingsmodulet

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

Før du tester
Som standard er betalingsmodulet sat på til at vise betalingsvinduet i din osCommerce eget layout. Du skal derfor sørge for, at det domæne som du tester fra, er opsat inde på din konto i ePay under "Indstillinger" og "Betalingssystemet". Hvis domænet ikke opsat, vil ePay relay-scriptet ikke kunne hente HTML-koden fra dit osCommerce system, og præsentere det over for dine kunder.

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".
Desuden skal punktet Integrated layout sættes til Standard Payment Window - popup under indstillingerne for betalingsmodulet.

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

	Du skal blot gennemføre et køb, som enhver kunde vil gøre det på siden. På checkout-siden vælges Credit Card ePay, og der trykkes videre til næste side.
	Herefter skal kunden godkende sin ordre, hvorefter kunden vil blive sendt til betalingssiden.
	Til venstre vises eksempel på det integrerede betalingsvindue.
	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 osCommerce.
	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 osCommercen

Når ordren findes frem inde i administrationen til osCommerce, vil der 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, svindelkontrol (Fraud Fighter), 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 osCommerce.

6. Indstillinger til ePay betalingsmodulet i osCommercer

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

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

Enabled	Denne indstilling benyttes til at angive om ePay er aktivt eller ej som betalingsform i din osCommerce. Denne skal som standard sættes til Enabled.
ePay Administration URL	Giver dig mulighed for at logge ind i administrationen til ePay ved hjælp af en direkte URL (så du slipper for at skulle indtaste brugernavn og password). Kontakt ePay support for at få udleveret en direkte URL til log ind.
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 payment 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 of display	Den rækkefølge som betalingsformen skal præsenteres i blandt de andre betalingsformer (i forbindelse med at kunden skal vælge, hvordan denne vil betale for sin ordre).
Payment zone	Her er det muligt at definere fra hvilket land, folk skal kunne betale med denne betalingsform.
Merchantnumber	Dit forretningsnummer modtaget af ePay. Dette finder du under menuen Indstillinger -> Betalingssystemet, når du er logget ind i ePay.
Show guide	Her kan der vælges, om guiden "Hvad er kontrolcifre" skal vises på siden med betalingsformularen i integreret layout.
Show ePay logo	Her kan der vælges, om ePay-logoet skal vises på siden med betalingsformularen i integreret layout.
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.
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.
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).
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 osCommerce	Denne funktion er vigtig, hvis du ønsker at behandle dine betalinger direkte fra ordre adminitrationen i osCommerce. 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 osCommerce. 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).
MD5 type	For at sikre de data der sendes mellem osCommerce 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 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 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.
Add 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 "order and invoice"	Aktiveres dette vil der blive lavet en ekstra linje på kundens ordre og faktura, hvor transaktionsgebyret står. Bemærk! For at få dette til at fungere, så skal Transaction fee under Modules -> Order Total aktiveres.
Enable 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.
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.
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 osCommerce 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 ikke ønsker at præsentere over for kunden.
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 osCommerce 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.

7. Opsætning af sprog

Ønsker du at ændre eller tilføje et sprog til ePay betalingsmodulet, kan du gøre følgende.

Navigere nu til folderen \includes\languages\english\modules\payment Åbn nu filen epaywindow.php, og foretag de ændringer, som du måtte ønske. 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. Ønsker du i stedet at tilføje en oversættelse af betalingsmodulet til et andet sprog, så kopiere du filen epaywindow.php til f.eks. \includes\languages\german\modules\payment Åben nu filen \includes\languages\german\modules\payment\epaywindow.php Den vil se ud som angivet til venstre. Her ligger de få antal sprog etiketter, der definerer sproget i ePay betalingsmodulet til osCommerce.

Opsætning af dansk til resten af osCommerce kan se ved at installere følgende sprogpakke: http://www.oscommerce.com/community/contributions,5684/category,7/.

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

Det er med ePay betalingsmodulet muligt at behandle betalingerne direkte fra ordre behandlingen i osCommerce, 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 osCommerce administration, skal indstillingen Process payments from within the order administration of osCommerce aktiveres til Enabled. Behandling af betalingerne fra osCommerce administration hedder hos ePay API / Remote interface Bemærk at når denne indstilling aktiveres i osCommerce skal den IP adresse som osCommerce 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 osCommerce, kommunikerer osCommerce 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 Eventuel beskrivelse Eventuel 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 Eventuel transaktionsgebyr
	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. osCommerce 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 eksisterende osCommerce filer

For at få ePay betalingsmodulet til at fungere, så overskrives allerede eksisterende osCommerce-filer. Hvis du allerede har foretaget ændringer i disse filer, bør disse flettes med filerne fra ePay betalingsmodulet. Følgendende osCommerce filer vil blive overskrevet af betalingsmodulet: /account_history_info.php /checkout_process.php /admin/orders.php /admin/invoice.php /admin/packingslip.php /admin/includes/languages/danish/orders.php /admin/includes/languages/english/orders.php /includes/classes/order.php Tilføjelser fra betalingsmodulet er i ovenstående filer markeret ved: // ------------ ePay added start --------- og // ------------ ePay added end ---------