RatePay

RatePay
RatePay
Inhoudsopgave
1. Introduction
2. Integration
3. Example
Page 1 of 6 - 30/12/2014
RatePay
1. Introduction
This guide should be read in conjunction with Ogone e-Commerce.
Notes:
RatePAY recommends setting the transaction processing to "authorisation". This can be done in the Ogone Back Office under
"Configuration > Technical Information > Global Transaction Parameters".
If your Ogone account is configured with "Direct Sale", this setting will be overridden by OPERATION=RES for all RatePay transactions
by our system.
Page 2 of 6 - 30/12/2014
RatePay
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://secure.ogone.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://secure.ogone.com/ncol/test/orderstandard_utf8.asp" method="post">

<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
30
AMOUNT
Y
N
15
CURRENCY
Y
AN
3
LANGUAGE
Y
AN
15
OPERATION
N
AN
3
SHASIGN
Y
AN
256
N = numeric, AN = alphanumeric
Meer informatie over deze velden vindt u in uw account. Meld u aan en ga naar: "Ondersteuning > Integratie & gebruikershandleidingen >
Technische handleidingen > Parameter Cookbook '.

<!—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="" />
Page 3 of 6 - 30/12/2014
RatePay
<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
Meer informatie over deze velden vindt u in uw account. Meld u aan en ga naar: "Ondersteuning > Integratie & gebruikershandleidingen >
Technische handleidingen > 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
Page 4 of 6 - 30/12/2014
RatePay
FACEXCLx
N
N
15
FACTOTALx
N
N
15
N = numeric, AN = alphanumeric / x: can be repeated n times
Meer informatie over deze velden vindt u in uw account. Meld u aan en ga naar: "Ondersteuning > Integratie & gebruikershandleidingen >
Technische handleidingen > 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.
Page 5 of 6 - 30/12/2014
RatePay
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 protected]
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 Ogone expects the amount to be multiplied by 100
Page 6 of 6 - 30/12/2014

Download Report