Hosted Payment Page

🚧

Please note

Our latest version of a simple, hosted payment solution is called Checkout, please check the docs there for our latest product.

This page refers to the Gateway's Hosted Payment Page (Connect) solution.

The Hosted Payment Page API 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:

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