Introduction

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

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

The following features are available today:

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

Use cases

Some example use cases for the payments api are:

  • A small to medium merchant wanting to process payments in a simple and quick-to-implement way

Your first implementation

Prereqs - ensure the following has been completed:

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, 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.

Click for example request / response
<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.