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.
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
Updated about 1 month ago