Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211...

33
Installation Manual Billmate Module osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö

Transcript of Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211...

Page 1: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

Installation Manual

Billmate Module

osCommerce

Billmate AB

Gustaf Adolfs Torg 47

211 39 Malmö

Page 2: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

2

Contents Install the plug-in ..................................................................................................................................... 4

Navigation ............................................................................................................................................... 5

Installation of Billmate Invoice ................................................................................................................ 6

Enable Billmate Module ...................................................................................................................... 6

Set Order Status .................................................................................................................................. 7

Merchant ID ......................................................................................................................................... 7

Shared Secret ...................................................................................................................................... 8

Product artno attribute ....................................................................................................................... 8

Countries ............................................................................................................................................. 9

Order value maximum limit................................................................................................................. 9

Order value minimum limit ............................................................................................................... 10

Ignore table ....................................................................................................................................... 10

Test Mode .......................................................................................................................................... 11

Payment Zone .................................................................................................................................... 11

Sort order of display .......................................................................................................................... 12

Installation of Billmate Card .................................................................................................................. 12

Enable Billmate Module .................................................................................................................... 13

Set Order Status ................................................................................................................................ 13

Merchant ID ....................................................................................................................................... 14

Shared Secret .................................................................................................................................... 14

Enable Display name ......................................................................................................................... 15

Enable 3D secure ............................................................................................................................... 15

Product artno attribute ..................................................................................................................... 16

Authentication Mode ........................................................................................................................ 16

Disabled Countries ............................................................................................................................ 17

Order value maximum limit............................................................................................................... 17

Order value minimum limit ............................................................................................................... 18

Ignore table ....................................................................................................................................... 18

Test Mode .......................................................................................................................................... 19

Payment Zone .................................................................................................................................... 19

Sort order of display .......................................................................................................................... 20

Installation of Billmate Bank ................................................................................................................. 20

Enable Billmate Module .................................................................................................................... 21

Page 3: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

3

Set Order Status ................................................................................................................................ 21

Merchant ID ....................................................................................................................................... 22

Shared Secret .................................................................................................................................... 22

Product attribute artno ..................................................................................................................... 23

Disabled Countries ............................................................................................................................ 23

Order value maximum limit............................................................................................................... 24

Order value minimum limit ............................................................................................................... 24

Ignore table ....................................................................................................................................... 25

Test mode .......................................................................................................................................... 25

Payment Zone .................................................................................................................................... 26

Sort order of display .......................................................................................................................... 26

Installation of Billmate Part payment ................................................................................................... 27

Enable Billmate Module .................................................................................................................... 27

Set Order Status ................................................................................................................................ 28

Merchant ID ....................................................................................................................................... 28

Shared Secret .................................................................................................................................... 29

Product artno attribute ..................................................................................................................... 29

Countries ........................................................................................................................................... 30

Order value maximum limit............................................................................................................... 30

Order value minimum limit ............................................................................................................... 31

Ignore table ....................................................................................................................................... 31

Sort order of display .......................................................................................................................... 32

Set database table for campaigns ..................................................................................................... 32

Test Mode .......................................................................................................................................... 33

PClasses / Campaigns ........................................................................................................................ 33

Page 4: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

4

Install the plug-in To install our plug-in so you will need to upload the files to your ftp.

Follow these steps:

1) Unzip the package (using WinZip or Winrar or similar program).

2) Upload it in the root of your store catalog with Filezilla or similar FTP program.

Here's how it might look in FileZilla:

Upload our files here and they will automatically end up in the right place and will not overwrite any

other files in the folders that our plug-in treats.

Then when you're upgrading, you simply overwrite all of our files in the same way as you did when

you uploaded the first time.

Page 5: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

5

Navigation You will find your Billmate modules here.

Page 6: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

6

Installation of Billmate Invoice Begin by clicking on Edit when you select the module in the list.

Enable Billmate Module

Here you enable or disable this payment method.

Page 7: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

7

Set Order Status

Here you can set the status of a new order when a customer uses this payment method.

Merchant ID Here you enter your four-digit key that you will find when you log on to Billmate Online and click

your way to Settings > Integration > Billmate API details.

Page 8: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

8

Shared Secret Here you enter your twelve-digit key that you will find when you log on to Billmate Online and click

your way to Settings > Integration > Billmate API details.

Product artno attribute

Here you can set whether to use the model or ID number as article number.

Page 9: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

9

Countries

Here you can set which countries you want to be able to use this payment option.

Order value maximum limit

Here you can put a maximum limit. Customer orders must be below this amount for this

payment method to appear.

Page 10: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

10

Order value minimum limit

Here you can put a minimum limit. Customer orders must be below this amount for this

payment method to appear.

Ignore table

Here you can choose to ignore any records from the total order value list when we compile

your invoices.

Page 11: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

11

Test Mode Here you can activate a test mode which means that you can make a test order without a proper

credit check is performed to ensure that the payment option works as it should. It is important that

the test mode is not activated when your store is active. This is because if a customer tries to place

orders with this payment option set to test mode, no real orders will be created in Billmate Online.

Payment Zone

Here you can set whether you want only specific zones to be able to use this payment

method.

Page 12: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

12

Sort order of display

Here you can sort the different payment methods. The lowest number will be top of the list

when the customer is in your check out.

Installation of Billmate Card Begin by clicking on Edit when you select the module in the list.

Page 13: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

13

Enable Billmate Module

Here you enable or disable this payment method.

Set Order Status

Here you can set the status of a new order when a customer uses this payment method.

Page 14: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

14

Merchant ID Here you enter your four-digit key that you will find when you log on to Billmate Online and click

your way to Settings > Integration > Billmate API details.

Shared Secret Here you enter your twelve-digit key that you will find when you log on to Billmate Online and click

your way to Settings > Integration > Billmate API details.

Page 15: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

15

Enable Display name Here you can choose if the customer should enter their first and last name in the payment window.

Enable 3D secure Here you can choose whether to enable 3D secure for your card module.

Page 16: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

16

Product artno attribute

Here you can set whether to use the model or ID number as article number.

Authentication Mode

Here you can set how you want the order to be processed when a customer uses Billmate

Card as payment option. Sale means that the card will be charged directly and

authentication means that the amount will be reserved on the card which you can then

manually charge afterwards.

Page 17: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

17

Disabled Countries

Here you can set which countries you do NOT want to be using this payment option.

Order value maximum limit

Here you can put a maximum limit. Customer orders must be below this amount for this

payment method to appear.

Page 18: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

18

Order value minimum limit

Here you can put a minimum limit. Customer orders must be above this amount for this

payment method to appear.

Ignore table

Here you can choose to ignore any records from the total order value list when we compile

your invoices.

Page 19: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

19

Test Mode Here you can activate a test mode that allows you to test it out with a test card for testing so that the

payment option works as it should. It is very important that the test mode is NOT activated when

your store is active because the real credit card will not be permitted in test mode!

Payment Zone

Here you can set whether you want only specific zones to be able to use this payment

method.

Page 20: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

20

Sort order of display

Here you can sort the different payment methods. The lowest number will be top of the list

when the customer is in your check-out.

Installation of Billmate Bank Begin by clicking on Edit after selecting the module in the list.

Page 21: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

21

Enable Billmate Module Here you can enable or disable this payment method.

Set Order Status Here you can set the status of an order should have when a customer uses this payment method.

Page 22: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

22

Merchant ID Here you enter your four-digit key that you will find when you log on to Billmate Online and click

your way to Settings > Integration > Billmate API details.

Shared Secret Here you enter your twelve-digit key that you will find when you log on to Billmate Online and click

your way to Settings > Integration > Billmate API details.

Page 23: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

23

Product attribute artno Here you can set whether to use the model or ID number as article number.

Disabled Countries Here you can set which countries you do NOT want to be able to take use this payment option.

Page 24: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

24

Order value maximum limit

Here you can put a maximum limit. Customer orders must be below this amount for this

payment method to appear.

Order value minimum limit

Here you can put a minimum limit. Customer orders must be above this amount for this

payment method to appear.

Page 25: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

25

Ignore table Here you can choose to ignore any records from the total order value list when we compile your

invoices.

Test mode Here you can activate a test mode that makes it possible to carry out a test purchase with a bank

payment. It is important that the test mode is not activated when your store is active. This is because

if a customer tries to place orders with this payment option set to test mode, no real orders will be

created in Billmate Online.

Page 26: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

26

Payment Zone Here you can set whether you want only specific zones to be able to use this payment method.

Sort order of display Here you can sort the different payment methods. With the lowest number will be at the top of the

list when the customer is in your check out.

Page 27: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

27

Installation of Billmate Part payment Begin by clicking on Edit when you select the module in the list.

Enable Billmate Module

Here you enable or disable this payment method.

Page 28: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

28

Set Order Status

Here you can set the status of a new order when a customer uses this payment method.

Merchant ID Here you enter your four-digit key that you will find when you log on to Billmate Online and click

your way to Settings > Integration > Billmate API details.

Page 29: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

29

Shared Secret Here you enter your twelve-digit key that you will find when you log on to Billmate Online and click

your way to Settings > Integration > Billmate API details.

Product artno attribute

Here you can set whether to use the model or ID number as article number.

Page 30: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

30

Countries

Here you can set which countries you want to be able to use this payment option.

Order value maximum limit

Here you can put a maximum limit. Customer orders must be below this amount for this

payment method to appear.

Page 31: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

31

Order value minimum limit

Here you can put a minimum limit. Customer orders must be below this amount for this

payment method to appear.

Ignore table

Here you can choose to ignore any records from the total order value list when we compile

your invoices.

Page 32: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

32

Sort order of display

Here you can sort the different payment methods. The lowest number will be top of the list

when the customer is in your check out.

Set database table for campaigns

This is only used to store part payment options. Do not change this!

Page 33: Installation Manual Billmate Module osCommerce · osCommerce Billmate AB Gustaf Adolfs Torg 47 211 39 Malmö 2 Contents Install the plug-in..... 4 Navigation ..... 5 Installation

33

Test Mode Here you can activate a test mode which means that you can make a test order without a proper

credit check is performed to ensure that the payment option works as it should. It is important that

the test mode is not activated when your store is active. This is because if a customer tries to place

orders with this payment option set to test mode, no real orders will be created in Billmate Online.

PClasses / Campaigns Here is where all of your part payment option details are stored.