WPGuiden.dk
- Lavet i samarbejde med ePay | Dit Online Betalingssystem
Joomla
Vejledning - fakturamodul  Vejledning - WP e-Commerce  Wordpress  ePay.dk
Vejledning
- til opsætning af ePay fakturamodul i WordPress

ePay stiller gratis et modul til betaling af fakturaer gennem WordPress til rådighed.
Dette modul er udviklet af ePay, og gør, at det er let at integrere ePay i WordPress.

Det er let at installere og teste ePay modulet til WordPress.
Lav en uforpligtende tilmelding her, og modtag et test-forretningsnummer fra ePay.





1. Få oprettet test-konto hos ePay
For at du kan teste fakturamodulet til WordPress, 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 WordPress. 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 WordPress
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 WordPress modulet her

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

Kopier herefter indholdet til din WordPress.

Åbner i et nyt vindue Gå nu til din WordPress administration http://dinurl/wp-admin og logind. Herefter vælges Plugins som vist til venstre.
Åbner i et nyt vindue Find i oversigten ePay og tryk på Aktiver. ePay modulet er nu klar til brug.


3. Opsætning af ePay fakturamodul i WordPress
Fakturamodulet er nu installeret, og vi er klar til opsætningen.


Åbner i et nyt vindue Tryk på knappen ePay i menu til venstre og vælg herefter ePay - Settings
Åbner i et nyt vindue Her angives det merchant number (forretningsnummer), der er modtaget af ePay (enten et test- eller produktion merchant number). Dette angives i feltet Forretningsnummer. Tryk på Gem ændringerne i bunden af siden.
Åbner i et nyt vindue Tryk nu på Sider i menuen til venste og vælg Tilføj ny.
Åbner i et nyt vindue I editoren indsættes følgende:
[epay_payment]


Tryk på Udgiv til venstre.


4. Test af fakturamodulet
Vi er nu klar til at teste fakturamodulet.

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



5. Information om betalingen i administrationen til WordPress
Åbner i et nyt vindue

Åbner i et nyt vindue
Når betalingen er gennemført vil denne være tilgængelig i WordPress 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 WordPress
Det anbefales kraftigt, at du nærlæser disse indstillinger.

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

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 WordPress. 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 WordPress. 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 WordPress.
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. Ønskes der ikke sendt nogle betalingsbekræftelse, så lad dette felt blive tomt (blank)
E-mail payment confirmation Her angives de e-mails, hvortil der skal sendes en kopi af betalingsbekræftelsen. Dette virker kun, hvis Company e-mail er angivet.
Show Cardholder name Sættes til Show, hvis kunden skal angive sit navn i 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 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 .po-filen, som befinder sig i
/wp-content/plugins/epay/

Du kan læse mere om ændring af sprog i WordPress her


8. Behandling af betalingerne fra WordPress administrationen (remote interface)
Det er med ePay fakturamodulet muligt at behandle betalingerne direkte fra ordre behandlingen i WordPress, uden at skulle logge ind i ePay og behandle betalingerne efterfølgende.

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

Åbner i et nyt vindue For at aktivere behandling af betalingerne fra WordPress administration, skal indstillingen Use API være sat til Yes.

Behandling af betalingerne fra WordPress administration hedder hos ePay API / Remote interface

Bemærk at når denne indstilling aktiveres i WordPress skal den IP adresse som WordPress systemet befinder sig på opsættes inde i administrationen til ePay. Dette sker under menuen API / Remote Interface -> Adgang.

Åbner i et nyt vindue Når ordren indlæses i administrationen i WordPress, kommunikerer WordPress 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


Åbner i et nyt vindue 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. WordPress 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 wp-content\plugins\epay\mail-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


10. Direkte link
Åbner i et nyt vindue Det er med WordPress fakturamodulet muligt at lave et direkte url til betalingssiden, hvor værdierne på nogle af felterne er angivet.

Dette kan f.eks. benyttes til at sende et link direkte til kunden.

URL'en defineres således:
http://dinWordPress.dk/index.php?page_id=[pageid]&set_amount=[amount]
&set_invoice=[invoice]&set_email=[email]&set_currency=[currency]
Værdierne erstattes som følger:
  • [pageid] erstattes med det side id som betalingssiden er tilknyttet i WordPress
  • [amount] beløbet angivet i minor units. Fx. skal DKK 125,75 angives som 12575 i amount feltet. Altså i øre.
  • [invoice] fakturanummeret
  • [email] kundens e-mail
  • [currency] valutaen som betalingen skal ske i


URL'en kan f.eks. således ud:
http://dinWordPress.dk/index.php?page_id=11&set_amount=5158
&set_invoice=81&set_email=kunde@email.dk&set_currency=208

Det vil sende kunden til en betalingsside som vist til venstre.
Læs mere om ePay | Dit Online Betalingssystem på www.epay.dk (Åbner i et nyt vindue) Læs mere om Joomla (Åbner i et nyt vindue) Valid HTML 4.0 Transitional