DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

EXT: Commerce iDEAL payment module

Author:Kasper Skårhøj
Created:2002-11-01T00:32:00
Changed:2007-10-31T23:09:56
Author:Michiel Roos
Email:extensions@netcreators.com
Info 3:
Info 4:

EXT: Commerce iDEAL payment module

Extension Key: nc_commerce_ideal

Copyright 2000-2002, Michiel Roos, <extensions@netcreators.com>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

- a GNU/GPL CMS/Framework available from www.typo3.com

Table of Contents

EXT: Commerce iDEAL payment module 1

Introduction 1

What does it do? 1

Screenshots 1

Users manual 2

Installation 2

Configuration 2

Example configuration 2

Reference 2

Security 3

Character set used in transaction 3

Known problems 4

To-Do list 4

Changelog 4

Introduction

img-1

What does it do?

Enable customers to pay for products using the iDEAL payment method. Currently this method is supported by the following banks:

  • ABN AMRO
  • Fortis
  • Postbank
  • Rabobank
  • SNS

Screenshots

Users manual

Installation

Install the extension with the extension manager.

Configuration

All configuration is done via TypoScript settings.

Example configuration

This is a TS configuration used in the default setup:

plugin.tx_commerce_pi3.iDEAL {
        Privatekey=priv.pem
        PrivatekeyPass=passwd
        Privatecert=cert.cer
        AuthenticationType=SHA1_RSA
        Certificate0=ideal.cer
        AcquirerURL=ssl://idealtest.secure-ing.com:443/ideal/iDeal
        AcquirerTimeout=10
        MerchantID=005010700
        SubID=0
        MerchantReturnURL=
        Currency=EUR
        ExpirationPeriod=PT10M
        Language=nl
        DESCRIPTION=default description
        EntranceCode=15674022
        LogFile=thinmpi.log
}

Reference

plugin.tx_commerce_pi3.iDEAL

::

Property

Privatekey

Data type

string

Description

The name of the key file

Default

priv.pem

::

Property

PrivatekeyPass

Data type

string

Description

The password for the private key file

Default

passwd

::

Property

Privatecert

Data type

string

Description

The name of the private certificate file

Default

cert.cer

::

Property

AuthenticationType

Data type

string

Description

The type of authentication used. Do not change this unless you have specific reasons to do so.

Default

SHA1_RSA

::

Property

Certificate0

Data type

string

Description

Contains the signing certificate of your acquirer. This field should not be changed.

Default

ideal.cer

::

Property

AcquirerURL

Data type

string

Description

Address of the iDEAL acquiring server.

Use ssl://idealtest.secure-ing.com:443/ideal/iDeal during integration/test

Use ssl://ideal.secure-ing.com:443/ideal/iDeal only for production

Do not change AcquirerTimeout unless you have specific reasons to do so

Default

ssl://idealtest.secure-ing.com:443/ideal/iDeal

::

Property

AcquirerTimeout

Data type

int

Description

Do not change AcquirerTimeout unless you have specific reasons to do so

Default

10

::

Property

MerchantID

Data type

int

Description

Default MerchantID enables you to test the example demoshop. Your own Merchant ID can be retrieved via the iDEAL Dashboard.

Default

005010700

::

Property

SubID

Data type

int

Description

Do not change subID unless you have specific reasons to do so.

Default

0

merchantReturnURL

Property

merchantReturnURL

Data type

string

Description

If true, thumbnails will NOT be made square by 'center cropping' the image.MerchantReturnURL is the URL on your system that the customer is redirected to after the iDEAL payment. This page should carry out the Status Request

MerchantReturnURL=http://[yourwebpage]/StatReq.php

Default

empty

::

Property

ExpirationPeriod

Data type

string

Description

ExpirationPeriod is the timeframe during which the transaction is allowed to take place Maximum is PT1H (1 hour).

Default

PT10M

::

Property

EntranceCode

Data type

int

Description

Used when you do not want to use transaction specific entrance codes. See documentation for more info.

Default

15674022

::

Property

Currency

Data type

string

Description

Do not change currenty unless you have specific reasons to do so

Default

EUR

::

Property

Language

Data type

string

Description

Language is only used for showing errormessages in the prefered language

Default

nl

::

Property

Description

Data type

string

Description

Used when you do not want to use transaction specific descriptions.

Default

0

::

Property

LogFile

Data type

string

Description

Specify an file to log transactions to

Default

thinmpi.log

Security

Make sure you protect the directory in which the certificates reside. This can be done for web visitors by setting an .htaccess file with the following contents:

AuthName "Leave!"
AuthType Basic
<Limit GET POST>
  order deny,allow
  deny from all
</Limit>

Character set used in transaction

When setting any of the configuration options that do not denote file paths, please only use characters in the character set described in the following table. Using a character that is not in the table will not result in the rejection of a batch or post, but will result in the translation of the characters to a space, question mark or asterisk. This also holds true for diacritic characters like ǔ, ã, ë, etc. The right most column shows the characters to which these will be translated.

::

Used characters

A to Z

Description

Uppercase letters

Translation in H

::

Used characters

a to z

Description

Lowercase letters

Translation in H

A to Z

::

Used characters

0 to 9

Description

Numbers

Translation in H

::

Used characters

=

Description

Equals sign

Translation in H

::

Used characters

Description

Space

Translation in H

::

Used characters

%

Description

Percent

Translation in H

::

Used characters

*

Description

Asterisk

Translation in H

::

Used characters

+

Description

Plus

Translation in H

::

Used characters

,

Description

Comma

Translation in H

::

Used characters

-

Description

Dash

Translation in H

::

Used characters

.

Description

Dot

Translation in H

::

Used characters

/

Description

Slash

Translation in H

::

Used characters

&

Description

Ampersand

Translation in H

::

Used characters

@

Description

At

Translation in H

::

Used characters

“

Description

Double quote

Translation in H

*

::

Used characters

'

Description

Single quote

Translation in H

*

::

Used characters

:

Description

Semicolon

Translation in H

*

::

Used characters

;

Description

Colon

Translation in H

*

::

Used characters

?

Description

Question mark

Translation in H

*

::

Used characters

(

Description

Left brace

Translation in H

*

::

Used characters

)

Description

Right brace

Translation in H

*

::

Used characters

$

Description

Dollar

Translation in H

*

Known problems

merchantReturnURL may not contain & character, it should be a clean URI to a path or file.

Please let me know if you run into any problems.

To-Do list

  • check shipping cost. Is it included in total net?
  • Should we use the checkExternalData (current setup) or the finishingFunction
  • build and use hand made entranceCode
  • move security (certs etc.) to other place (not inside lib/iDeal/secutiry)

Changelog

0.0.1 (ALPHA)

Version

0.0.1 (ALPHA)

Changes

Initial release

Date

29-10-2007

img-2 EXT: Commerce iDEAL payment module - 4