Copyright 2017 Ingenico epayments. RatePay

Size: px

Start display at page:

Lester Lucas
5 years ago
Views:

1 RatePay

2 Table of contents 1. Introduction 2. Integration 3. Example Page 1 of 6-09/09/2017

3 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. Page 2 of 6-09/09/2017

4 2. Integration In Test, you should send your transactions to /ncol/test/ whereas in Production it should be sent to /ncol/prod/ <form action=" method="post"> If your website and payment page are UTF-8, you should call our UTF-8 page instead: <form action=" 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 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".  <! 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-09/09/2017

5 <input type="hidden" name="ownercty" value="" /> <input type="hidden" name="ownertelno" value="" /> <input type="hidden" name=" " 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 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 Page 4 of 6-09/09/2017

6 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. Page 5 of 6-09/09/2017

7 3. Example PSPID=xxxxxx ORDERID= 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= itemid1=111 itemname1=artikel1 itemprice1= itemquant1=4 itemvat1= facexcl1= factotal1= * 4 = (= FACEXCL1) * 4 = = (= FACTOTAL1) itemid2=222 itemname2=artikel2 itemprice2= itemquant2=1 itemvat2= facexcl2= factotal2= * 1 = (= FACEXCL2) * 1 = = (=FACTOTAL2) ROUND( ,2) = (ROUND(FACTOTAL1 + FACTOTAL2,2) = AMOUNT) => AMOUNT = 5090 because Ingenico epayments expects the amount to be multiplied by 100 Page 6 of 6-09/09/2017

RatePay. Table des matières. 1. Introduction. 2. Integration. 3. Example

RatePay. Table des matières. 1. Introduction. 2. Integration. 3. Example Table des matières 1. Introduction 2. Integration 3. Example Page 1 of 6-09/09/2017 1. Introduction This guide should be read in conjunction with Ingenico epayments e-commerce. Notes: RatePAY recommends