Last update 10/12/2015

1. Introduction

This guide should be read in conjunction with Ingenico ePayments e-Commerce.

Notes:

  • RatePAY recommends setting the transaction processing to "authorisation". This can be done in the Ingenico ePayments Back Office under "Configuration > Technical Information > Global Transaction Parameters".
  • If your Ingenico ePayments account is configured with "Direct Sale", this setting will be overridden by OPERATION=RES for all RatePay transactions by our system.

2. Integration

In Test, you should send your transactions to …/ncol/test/… whereas in Production it should be sent to …/ncol/prod/…

<form action="https://ogone.test.v-psp.com/ncol/test/orderstandard.asp" method="post">

If your website and payment page are UTF-8, you should call our UTF-8 page instead:

<form action="https://ogone.test.v-psp.com/ncol/test/orderstandard_utf8.asp" method="post">

<!-- normal Ingenico ePayments e-Commerce Parameters -->

<input type="hidden" name="PSPID" value="" />
<input type="hidden" name="ORDERID" value="" />
<input type="hidden" name="AMOUNT" value="" />
<input type="hidden" name="CURRENCY" value="" />
<input type="hidden" name="LANGUAGE" value="" />
<input type="hidden" name="OPERATION" value="" />
<input type="hidden" name="SHASIGN" value="" />

Parameter Mandatory Format Length
PSPID Y AN 15
ORDERID Y AN 40
AMOUNT Y N 15
CURRENCY Y AN 3
LANGUAGE Y AN 15
OPERATION N AN 3
SHASIGN Y AN 256

N = numeric, AN = alphanumeric

More information about these fields can be found in your account. Just log in and go to: "Support > Integration & user manuals > Technical guides > Parameter Cookbook". 

<!-- RatePAY Parameters -->

<!—Buyer -->

<input type="hidden" name="ECOM_BILLTO_POSTAL_NAME_FIRST" value="" />
<input type="hidden" name="ECOM_BILLTO_POSTAL_NAME_LAST" value="" />
<input type="hidden" name="ECOM_SHIPTO_DOB" value="" />
<input type="hidden" name="OWNERADDRESS" value="" />
<input type="hidden" name="ECOM_BILLTO_POSTAL_STREET_NUMBER" value="" />
<input type="hidden" name="OWNERZIP" value="" />
<input type="hidden" name="OWNERTOWN" value="" />
<input type="hidden" name="OWNERCTY" value="" />
<input type="hidden" name="OWNERTELNO" value="" />
<input type="hidden" name="EMAIL" value="" />

Parameter Mandatory Format Length
ECOM_BILLTO_POSTAL_NAME_FIRST Y AN 35
ECOM_BILLTO_POSTAL_NAME_LAST Y AN 35
ECOM_SHIPTO_DOB Y AN 10
OWNERADDRESS Y AN 35
ECOM_BILLTO_POSTAL_STREET_NUMBER Y AN 10
OWNERZIP Y AN 10
OWNERTOWN Y AN 25
OWNERCTY Y AN 2
OWNERTELNO Y AN 30
EMAIL Y AN 50

N = numeric, AN = alphanumeric

More information about these fields can be found in your account. Just log in and go to: "Support > Integration & user manuals > Technical guides > Parameter Cookbook".

<!—Shopping Basket -->

<input type="hidden" name="ITEMID1" value="" />
<input type="hidden" name="ITEMNAME1" value="" />
<input type="hidden" name="ITEMPRICE1" value="" />
<input type="hidden" name="ITEMQUANT1" value="" />
<input type="hidden" name="ITEMVAT1" value="" />
<input type="hidden" name="FACEXCL1" value="" />
<input type="hidden" name="FACTOTAL1" value="" />

Parameter Mandatory Format Length
ITEMIDx Y N 15
ITEMNAMEx Y AN 40
ITEMPRICEx Y N 15
ITEMQUANTx Y N 15
ITEMVATx Y N 15
FACEXCLx N N 15
FACTOTALx N N 15

N = numeric, AN = alphanumeric / x: can be repeated n times

More information about these fields can be found in your account. Just log in and go to: "Support > Integration & user manuals > Technical guides > Parameter Cookbook". 

ITEMPRICE, ITEMQUANT, ITEMVAT, FACEXCL, FACTOTAL:
Decimals are separated by a full stop ".", not a comma!

ITEMPRICE, ITEMVAT und FACEXCL must be transmitted with 4 decimal places.
ITEMVAT is the VAT amount, NOT the VAT rate.
The sum of ITEMPRICE, ITEMVAT and FACEXCL is rounded off after the addition of all the amounts.

FACEXCLx = Item amount without VAT.
FACTOTALx = Item amount with VAT.
SUM(FACTOTALx) = AMOUNT (Sum of all item amounts)

RatePAY recommends using FACEXCLx and FACTOTALx in order to avoid rounding errors.

3. Example

PSPID=xxxxxx
ORDERID=123456789
AMOUNT=5090
CURRENCY=EUR
LANGUAGE=de_DE
SHASIGN=9249F0999C1AB1F63E70E377D577F58065E62293

ECOM_BILLTO_POSTAL_NAME_FIRST=Peter
ECOM_BILLTO_POSTAL_NAME_LAST=Müller
ECOM_SHIPTO_DOB=14/02/1980
OWNERADDRESS=Hauptstr.
ECOM_BILLTO_POSTAL_STREET_NUMBER=12a
OWNERZIP=89123
OWNERTOWN=München
OWNERCTY=DE
OWNERTELNO=089 123456789
EMAIL=peter@mueller.de

itemid1=111
itemname1=Artikel1
itemprice1=9.6639
itemquant1=4
itemvat1=1.8361
facexcl1=38.6556
factotal1=46.00

9.6639 * 4 = 38.6556 (= FACEXCL1)
1.8361 * 4 = 7.3444
38.6556 + 7.3444 = 46.0000 (= FACTOTAL1)

itemid2=222
itemname2=Artikel2
itemprice2=4.1176
itemquant2=1
itemvat2=0.7824
facexcl2=4.1176
factotal2=4.90

4.1176 * 1 = 4.1176 (= FACEXCL2)
0.7824 * 1 = 0.7824
4.1176 + 0.7824 = 4.9000 (=FACTOTAL2)

ROUND(46.0000 + 4.9000,2) = 50.90
(ROUND(FACTOTAL1 + FACTOTAL2,2) = AMOUNT)
=> AMOUNT = 5090 because Ingenico ePayments expects the amount to be multiplied by 100 

This website uses cookies to be able to give you the best user experience. If you don't want to accept these cookies, we allow you to change the cookie settings. Click 'Accept' to allow all cookies from this website.

Cookie settings

Introduction

Functional

Functional cookies are required for the website to operate correctly. These cookies cannot be disabled.

Optimized

Optimization cookies allow us to analyze site usage so we can measure and improve our website.
This is the default level.

Personalized

Personalization cookies are used for social media and advanced personalization. They allow us to show you information related to your company.


Example functionality allowed

  • Store country preference
  • Store language preference

Example functionality not allowed

  • Saving personal data
  • Anonymous tracking via Google Analytics
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics

Example functionality not allowed

  • Saving personal data
  • Tracking for remarketing purposes

Example functionality allowed

  • Store country preference
  • Store language preference
  • Anonymous tracking via Google Analytics
  • Serve content relevant to your interests
  • Serve ads relevant to your interests
  • Tracking for remarketing purposes

Example functionality not allowed

  • Saving personal data