Vai al contenuto principale
English (US) Français Português

HiPay Enterprise – iDEAL

ideal_80x71.png

Service endpoints

There are two endpoints (base URLs) to which you can make your API calls:

  • Stage, if you are testing your integration,
  • and Production, when you have finished testing and want your application to go live.
Environment Endpoint

Stage

https://stage-secure-gateway.hipay-tpp.com/rest/v1/order

https://stage-secure-gateway.hipay-tpp.com/rest/v1/hpayment

Production

https://secure-gateway.hipay-tpp.com/rest/v1/order

https://secure-gateway.hipay-tpp.com/rest/v1/hpayment

 

Request parameters

To create an iDEAL transaction on the HiPay Enterprise Payment Gateway, you must send these mandatory/complementary parameters in your transaction creation call.

(For further details, please refer to the technical documentation.)

 

Format abbreviation Description
A Alphabetic characters only (a-z, A-Z)
AN Alphanumeric characters (a-z, A-Z, 0-9)
N Numeric characters only
R Decimal number with explicit decimal point, signed

 

Field name Format Req. Description
orderid AN

M

 Order ID
operation

A

 M
  • sale
payment_product AN M iDEAL
issuer_bank_id AN  

This is the Business Identifier Code (BIC) of the customer’s issuer bank.

More details here:

https://developer.hipay.com/
description AN M Description of the order
long_description AN   Detailed description of the order
currency A  M Required value: EUR
amount R M Use decimal point as separator
email AN   Customer’s email address
phone N  

Customer’s phone number

E.g.: 3xx xxxxxxx
birthdate AN   Customer’s birthdate (YYYYMMDD)
firstname AN M Customer’s first name
lastname AN M Customer’s last name
streetaddress AN   Customer’s billing address
city

A

   City of the customer’s billing address
zipcode N   Postal code of the customer’s billing address
country A  

Country code of the customer’s billing address

This two-letter country code complies with ISO 3166-1 (alpha 2).

Required value: IT

shipto_firstname AN   First name of the order’s recipient
shipto_lastname AN   Last name of the order’s recipient
shipto_phone N   Recipient’s phone number
shipto_streetaddress AN   Recipient’s shipping address
shipto_city AN   City of the recipient’s shipping address
shipto_zipcode N   Postal code of the recipient’s shipping address
shipto_country AN  

Country code of the recipient’s shipping address

This two-letter country code complies with ISO 3166-1 (alpha 2).
eci N  

 7: E-commerce with SSL/TLS Encryption
accept_url AN M Mandatory if not configured in the back office
decline_url AN M Mandatory if not configured in the back office
exception_url AN M Mandatory if not configured in the back office
cancel_url AN M Mandatory if not configured in the back office

 

Request example 

{
“orderid” : “123abc0cba321”,
“operation” : “sale”,
“payment_product” : “ideal”,
“issuer_bank_id” : “ABNANL2A”,
“description” : “Description of the order”,
“long_description” : “Detailed description of the order”, 
“currency” : “EUR”,
“amount” : “100”,
“accept_url” : “http://www.mysite.com/accept”,
“decline_url” : “http://www.mysite.com/decline”,
“pending_url” : ”http://www.mysite.com/pending”,
“exception_url” : “http://www.mysite.com/exception”,
“cancel_url” : “http://www.mysite.com/cancel”,
“firstname” : “Mario”,
“lastname” : “ROSSI”,
“streetaddress” : “Westermarkt 20”,
“streetaddress2” : ””,
“city” : “Amsterdam”,
“state” : “Amsterdam”,
“zipcode” : “1016 GV”,
“country” : “NL”,
“shipto_firstname” : “Maria”,
“shipto_lastname” : “Bianchi”,
“shipto_streetaddress” : “Westermarkt 20”,
“shipto_streetaddress2” : “”,
“shipto_city” : “Amsterdam”,
“shipto_state” : “Amsterdam”,
“shipto_zipcode” : “1016 GV”,
“shipto_country” : “NL”,
“eci” : “7”
}

 

API response

This service returns a forward URL, where customers are redirected.

(For further details, please refer to the technical documentation.) 

Response example 

<?xml version="1.0" encoding="UTF-8"?>
<response>
 <state>forwarding</state>
 <reason/>
<forward_url>https://stage-secure-gateway.hipay-tpp.com/gateway/forward/987654321a123b0b1fabcd98a7654321</forward_url>
 <test>true</test>
 <mid>00001234455</mid>
 <attempt_id>1</attempt_id>
 <authorization_code/>
 <transaction_reference>800000112233</transaction_reference>
 <date_created>2018-11-05T17:45:17+0000</date_created>
 <date_updated>2018-11-05T18:45:18+0100</date_updated>
 <date_authorized/>
 <status>140</status>
 <message>Authentication requested</message>
 <authorized_amount>0.00</authorized_amount>
 <captured_amount>0.00</captured_amount>
 <refunded_amount>0.00</refunded_amount>
 <credited_amount>0.00</credited_amount>
 <decimals>2</decimals>
 <currency>EUR</currency>
 <ip_address>0.0.0.0</ip_address>
 <ip_country/>
 <device_id/>
 <cdata1>
.
.
.
 </cdata10>
 <avs_result/>
 <cvc_result/>
 <eci>7</eci>
 <payment_product>ideal</payment_product>
 <payment_method/>
 <three_d_secure/>
 <fraud_screening>
 <scoring>0</scoring>
 <result>ACCEPTED</result>
 <review/>
 </fraud_screening>
 <order>
 <id>
 <![CDATA[1231230123]]>
 </id>
 <date_created>
 <![CDATA[2018-11-05T17:45:17+0000]]>
 </date_created>
 <attempts>
 <![CDATA[1]]>
 </attempts>
 <amount>
 <![CDATA[100.00]]>
 </amount>
 <shipping>
 <![CDATA[0.00]]>
 </shipping>
 <tax>
 <![CDATA[0.00]]>
 </tax>
 <decimals>
 <![CDATA[2]]>
 </decimals>
 <currency>
 <![CDATA[EUR]]>
 </currency>
 <customer_id>
 <![CDATA[]]>
 </customer_id>
 <language>
 <![CDATA[en_US]]>
 </language>
 <email>
 <![CDATA[]]>
 </email>
 </order>
 <debit_agreement>
 <id/>
 <status/>
 </debit_agreement>
</response>

 

Server-to-server notifications

The server-to-server notifications related to this payment method will include all the basic information (detailed here) plus the following specific information related to the iDEAL transaction:

<payment_method> 
   <iban_debtor>NL63BARC200XXXXXXXXXXX</iban_debtor>
   <bic_debtor>CRLYFRPPXXX</bic_debtor>
   <account_holder_name>Mario ROSSI</account_holder_name>
</payment_method>

Please note that to receive these fields in your server-to-server notifications, you must activate them in HiPay Console under: Integration -> Notifications -> Fields -> payment_method

 

Transaction consultation

The transaction consultation method related to a transaction paid through this payment method will include all the basic information (detailed here) plus the following specific information related to the iDEAL payment method used:

<payment_method> 
   <iban_debtor>NL63BARC200XXXXXXXXXXX</iban_debtor>
   <bic_debtor>CRLYFRPPXXX</bic_debtor>
   <account_holder_name><![CDATA[Mario ROSSI]]></account_holder_name>
</payment_method>

 

Articoli correlati