myPOS™ logo sm
Indietro

osCommerce Installation

In order to install myPOS™ Virtual plugin please follow the described steps below:

1. Search for myPOS™ Virtual plugin at addons.oscommerce.com.

1. Search for myPOS™ Virtual plugin at addons.oscommerce.com.

2. Download the plugin.

3. After extracting the Add_On package, copy the files to your osCommerce installation directory.

4. Sign in to your osCommerce site as an administrator.

4. Sign in to your osCommerce site as an administrator.

5. Go to Administration Tool > Modules > Payment > Install Module page.

5. Go to Administration Tool > Modules > Payment > Install Module page.

6. Select myPOS™ Virtual payment method and click on 'Install Module' button.

6. Select myPOS™ Virtual payment method and click on

7. Once myPOS™ Virtual is installed it is visible within Payment Modules list.

7. Once myPOS™ Virtual is installed it is visible within Payment Modules list.


Configuration

In order to configure payment module you need to visit the method configuration page.

Configuration

Sign up for a myPOS™ account.

First, to use this payment option you need to sign up for a myPOS™ account at mypos.eu.

Sign up for a myPOS™ account.

Sign up for a myPOS™ account.

Adding of an online store

Once you have myPOS™ Account you need to go to the eCommerce > Online stores > Add new store.

You need to fill in all required fields:

Adding of an online store

Setting up the new online store

Once added, the new online store will be visible at the eCommerce > Online stores menu. The new online store will be with status 'Disabled'. You need to:

1. Read carefully and agree with the General terms and conditions and the Tariff for this store.

2. Set key pairs for this particular website.

For signing process, both myPOS™ Virtual API and the merchant generate public/private key pairs and exchange the public certificate. By clicking on the 'Generate new keys' button at Keys menu public/private key could be generated.

Once added, the new online store will be visible at the eCommerce > Online stores menu. The new online store will be with status

myPOS™ Virtual API requires from merchant to upload his public certificate so that his digital signature can be verified from the system. The merchant can upload several public certificates. A key index is assigned to each certificate. For each of the merchant's public certificate there is a certain myPOS™ public certificate.

You can download each myPOS™ public certificate by clicking on Download in the myPOS™ public certificate column.

3. Enable the store by clicking on the appropriate button beside the store.

Please have in mind that your stores need to be verified by Satabank which will take up to 5 business days. Until your online stores are verified, you can still process transactions but with certain limits.

Configuration of myPOS™ Virtual as a payment method

In order to configure payment module you need to choose myPOS™ Virtual from the list of available payment methods and click on the 'Edit' button.

Configuration of myPOS™ Virtual as a payment method

1. Enable myPOS™ Virtual Payment Method

Enable myPOS™ Virtual Payment Method

2. Test mode

Test environment mimics production environment and you can make all you requests to the system as you will do in production environment. You could test with every debit or credit card number.
In test environment all card transactions will be processed as successful payment. Your card will not be charged.

Test mode

If test mode is enabled (marked 'True' checkbox) you need to use the following testing data:

Testing data


Link pagamento myPOS™ Virtual
https://www.mypos.eu/vmp/checkout-test

Store ID
000000000000010

Numero conto myPOS™
61938166610

Developer Private Key

Sviluppatori certificato pubblico myPOS™

3. Configure values in Settings section.

a ) Sort order of display.

Store ID is given when you add a new online store.

b ) Store ID is given when you add a new online store.

Store ID is given when you add a new online store.

Available at mypos.eu:

Store ID is given when you add a new online store.

c ) Client number

Client number

Available at mypos.eu:

Client number

d ) chiave privata

Private Key could be generated by clicking on the ‘Generate new keys’ button at mypos.eu > menu eCommerce > Online Stores > Keys menu.

chiave privata

chiave privata

You need to copy your Private Key to the osCommerce platform:

chiave privata

e ) myPOS™ Public Certificate

È disponibile per il download su mypos.eu > menu servizi merchant > myPOS™ Virtual > Negozi on-line > Pulsanti menu.

myPOS™ Public Certificate

You need to copy this myPOS™ Public certificate to the osCommerce platform/field myPOS™ Public Certificate.

myPOS™ Public Certificate

f ) Indice chiave

You can upload several public certificates. Here you need to fill in the key index of the certificate which is copied in the osCommerce platform.

Indice chiave

Available at mypos.eu:

Indice chiave

g ) URL

Developer URL: https://www.mypos.eu/vmp/checkout-test
Production URL: https://www.mypos.eu/vmp/checkout


4. Save configuration changes by clicking on the 'Save' button.

Indice chiave

Important notes on technical integration:

  • URL Notify is the address where myPOS™ Virtual sends the parameters for successful payment. In order to have a successful transaction it should be SSL-enabled address only, i.e. it must start with "https://". Unsecure URLs will be treated as wrong and transactions will be automatically reversed by the system.
  • Upon HTTP request, the Merchant should respond with header HTTP 200 OK with the following body content: “OK”. Every other response will be treated as communication error, call error, server error or system malfunctions.

Once myPOS™ Virtual is configured your customers will be able to choose it as a payment method and pay for your goods and services easily and secure using their Debit/Credit card.

Save configuration changes by clicking on the 'Save' button.