Introduction

The Hosted Payment Page (Connect) enables the processing of payments in a simple, hosted solution without the need for storing payment information and PCI Compliance concerns.

The Hosted Payment Page (Connect) solution provides several different options for the payment process to support integrations where you handle most of the customer interactions on your own website up to integrations where you use ready-made form pages for the entire payment process.

For a more flexible but complex way to integrate if you need full control of the payment flow, take a look at our Payment API guides.

📘

Features

• Redirect to a hosted payment page to handle the checkout process
• Optional 3-D Secure configuration for additional security customisation
• Multiple payment methods supported

Initial setup

Prerequisities - please ensure the following has been completed:

• Complete the general Getting started guide and get your sandbox API Key

The sandbox is a fully connected test environment which can be used to simulate payment transactions.

Creating a payment form

To submit a transaction via the hosted payment page (HPP), you must have a page that submits a form as follows (substituting correct values for hashExtended, storename etc. where necessary):

📘

For more detail on how to generate hashExtended, see the 'Generate a hash' guide.

<form id="paymentForm" method="post" action="https://test.ipg-online.com/connect/gateway/processing" target="_blank">
  <input type="text" name="chargetotal" value="13.99" readOnly />
  <input type="hidden" name="currency" value="978" readOnly />
  <input type="hidden" name="hash_algorithm" value="HMACSHA256" readOnly />
  <input type="hidden" name="hashExtended" value="qnR8UCqJggD55PohusaBNviGoOJ67HC6Btry4qXLVZc=" readOnly />
  <input type="hidden" name="language" value="en_GB" readOnly />
  <input type="hidden" name="responseFailURL" value="https://my-ecom-website.com/failure" readOnly />
  <input type="hidden" name="responseSuccessURL" value="https://my-ecom-website.com/success" readOnly />
  <input type="hidden" name="storename" value="72305408" readOnly />
  <input type="hidden" name="timezone" value="Europe/Berlin" readOnly />
  <input type="hidden" name="txndatetime" value="2022-06-22T18:37:32" readOnly />
  <input type="hidden" name="txntype" value="sale" readOnly />
  <input type="submit" value="Submit" />
</form>

{
  txndate_processed=20/04/10 13:37:33, 
  ccbin=542606, 
  timezone=CET, 
  oid=C-2101f68a-45e9-4f3c-a6da-1337d5574717, 
  cccountry=N/A, 
  expmonth=12, 
  currency=978, 
  chargetotal=13.99, 
  approval_code=Y:ECI2/5:Authenticated, 
  hiddenSharedsecret=sharedsecret, 
  hiddenTxndatetime=2019:04:10-13:37:08, 
  expyear=2024, 
  response_hashExtended=927d3c3108d596c593f74fd79184ece7c33103fe, 
  response_code_3dsecure=1, 
  hiddenStorename=12345678, 
  transactionNotificationURL=https://test.ipg-online.com/webshop/transactionNotification, 
  tdate=1554903428, 
  ignore_refreshTime=on, 
  ccbrand=VISA, 
  txntype=sale, 
  paymentMethod=V, 
  txndatetime=2020:04:10-13:37:08, 
  cardnumber=(VISA) ... 4979, 
  ipgTransactionId=84120276797, 
  status=APPROVED
}

Clicking the 'submit' button will submit the form and perform the redirect to our hosted payment page at https://test.ipg-online.com/connect/gateway/processing (from the 'action' field).

Upon submitting the payment information, the Hosted Payment Page will send back a response similar to the above example to either the responseFailURL or responseSuccessURL.

See this page for detail on the response.

🚧

Production

In order to use the full feature-set of these APIs in production you must:

• Have an approved production API Key
• Be onboarded to our payment gateway
• Use a Message Signature in all requests. Please check this page

When making decisions on your way of integration, please consider that we do not recommend to use the hosted payment forms inside an iFrame since some Internet browsers do not allow cookies to be sent to the 3rd party hosts, moreover some features (e.g.: 3-D Secure authentications) and some Alternative Payment methods that involve redirections to the 3rd party services (e.g.: iDEAL or PayPal) do not allow displaying their screens within an iFrame.

However, if you still plan to embed our Hosted Payment Pages inside an iFrame you must use the 'parentUri' parameter to specify an URL of a page, where the Hosted Payment Page will be embedded.