Implementation document (x)

plumpbustlingInternet and Web Development

Dec 4, 2013 (3 years and 7 months ago)

82 views


1

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop













Implementation of
Netgíró
payment plugin
for HikaS
hop

(Joomla web
-
shop)

(v 1.
1
)





2

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop

Contents

1

Document changes

................................
................................
................................
................................

3

2

Introduction

................................
................................
................................
................................
...........

4

3

Installation

................................
................................
................................
................................
.............

5

3.1

Plugin Con
figuration

................................
................................
................................
......................

5

3.1.1

Publish and Configuration of the plugin

................................
................................
................

5

3.2

HikaShop configuration

................................
................................
................................
.................

8

3.2.1

Currency

................................
................................
................................
................................

8

3.2.2

Email

................................
................................
................................
................................
......

8

4

Plugin Workf
low

................................
................................
................................
................................
....

9





3

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop

1

Document changes

Version

Date

Author

Notes

1.0

12.9
.2013.

Stefan Novaković

Initial release

1.1

03.10.2013

StefanNovaković

Added payment options





4

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop

2

Introduction


Netgíró

payment plugin provides

simple and easy solution for
integrating
Netgíró

payment system with
HikaS
hop (
web
-
shop for Joomla).


5

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop

3

Installation


Installation of the plugin is the same as installation of any Joomla plugin.
Requirement for plugin
to work
is

to have HikaShop already

installed and configured.

HikaShop and all of the documentation for
installing

and configuring can be found here
http://extensions.joomla.org/extensions/e
-
commerce/shopping
-
cart/14275


3.1

Plugin Configuration


After insta
llation
we need to publish and configure plugin
.


3.1.1

Publish

and Configuration of the
plugin

Go to:

Components

>

HikaShop

-
>

System
-
> Payment me
thods

You should see screen as shown in image below.


Click on the new button to add a new payment
method
. From the list choose “
HikaShop
Netgíró

payment plugin
”.

You

should see configuration page for
Netgíró

plugin.


6

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop

3.1.1.1

Generic information





Published
:
This option allow you to publish or not the payment method.



Images
: Select here the desired images to display for this payment method.



Price
: You can set the payment fee in this field, and select the currency of the fee.



Percentage
: The percentage allow to

define a payment fee depending on the total cart price
.

In generic configuration we will only change Published to be Yes
.

3.1.1.2

Adding a
n
etgíró
image

If we want a
Netgíró

logo to be shown beside payment option we need to manualy add the logo in
side

folder:

P
ATH_TO_JOOMLA
\
media
\
com_hikashop
\
images
\
payment

Netgiro logo can be faound here:

https://www.netgiro.is/content/images/logo.png



7

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop

3.1.1.3

Specific Informations





Application Id
: Your
Netgíró

Merchant
identifier
.



Secret Access Key
:
Your

Netgíró

S
ecret K
ey
.



Mode
: You can choose here the environment to use.
Test

is used for testing the
Netgíró

payment
method with a
test

account, so that you can check if your parameters are right and see if data are
transmitted. This environment is used during the test phase and transactions will not be credited,
once your method is rightly configured, you can switch to the Production/L
iv
e mode with your real
account. More about Test account
https://www.
Netgíró
.is/Assistance/Documentation




Max number o
f

installments:
Defines what is maximum number of installm
ents in case
of
partial

payment
(integer). (2
-
12)



14 days payment
:
This is default payment option. In case none of the payment option is selected
this one will be used.



Partial Payments
:
Enable or disable partial payments
.



Partial Payments without interest
:
Enable or
disable partial payments
.


We will leave mode to be TEST mode.

Payment options

enable or disable as desired.

Test data:



ApplicationID:

881E674F
-
7891
-
4C20
-
AFD8
-
56FE2624C4B5


8

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop



SecretKey:
YCFd6hiA8lUjZejVcIf/LhRXO4wTDxY0JhOXvQZwnMSiNynSxmNIMjMf1HHwdV6cMN4
8NX3ZipA9q9hLPb9C1ZIzMH5dvELPAHceiu7LbZzmIAGeOf/OUaDrk2Zq2dbGacIAzU6yyk4KmOXRa
SLi8KW8t3krdQSX7Ecm8Qunc/A=



3.1.1.4

Main information

Here you can change Name and the Description for
Netgíró

payment

method.
This information’s will be
presented to the
customer

prior to selecting desire payment method.

It’s recommended to leave this
information as it is.


3.2


HikaShop configuration

3.2.1

Currency

Netgíró

payment plugin supports only

Icelandic
króna

(ISK)
for the currency. In order for the plugin to
work and to be presented to the
customer as

a payment method HikaShop

has to be con
figured to

use
ISK for currency.



3.2.2

Email

Netgíró

plugin
send

emails to

notify administrator

after order have been created and after we receive
payment notification from
Netgíró
.
We need to set administrator email that we want to use for
notifications.

Go
to:


Components
-
> HikaShop
-
> Configuration

Scroll to Emails section. Provide desire email addresses for the
Payment notifications email address and
Order creation notifications email address
.


9

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop

4


Plugin Workflow


If everything is configured correctly
Netgíró

should be presented as a possible payment method in our
shopping cart as shown in image below.



10

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop

䅦t敲eproc敥T楮g⁵獥爠睩汬wb攠pr敳ent敤⁷i瑨⁴桥⁰ ym敮琠op瑩tn猠瑨t琠have⁢ 敮⁥n慢汥l⁩渠 汵g楮
con晩fura瑩tn⁩渠獥 瑩tn ″.1⸱⸳⁳灥捩晩
con晩fura瑩tn.


䅦t敲eproc敥T楮g⁷楴i⁰ ym敮t

p汵g楮⁷楬l⁲敤er散e
捵stom敲

to
Ne瑧tró

paym敮t⁳楴攠睨敲攠


睩汬e敤e
toog楮
慮T
con晩fm⁴he⁰ ym敮琮†Nm慩ao瑩晩ta瑩on⁴ha琠orT敲e楳⁣r敡t敤⁷楬氠l攠獥s琠to⁴he⁣ustom敲e
慮T⁴o⁴h攠慤m楮楳瑲ator⸠



11

Netgíró



paym敮琠p汵g楮⁦o爠䡩k慓hop


After
customer confirms the purchase

he will be redi
rected
to Thank you page.



Order

status will

changed

to confirmed. History of the order will be populated with confirmed status
together with
Netgíró

Invoice number and
Netgíró

Confirmation Code that
Netgíró

has

send
.

Email will
be send to administrator to notify him of the successful payment.