Expiration times for Hosted Payment Pages (HPP) Release Notes

March 28, 2019

We are happy to announce that for our Hosted Payment Pages (HPP) it is now possible to specify an expiration time. The expiration time is relative to the creation time of the HPP and not from when the customer visit the HPP.

What happens if an expiration time is specified?

  1. A count-down is shown to the customer while they are on the HPP
  2. If the expiration time is met the customer is automatically redirected to the provided Abort URL
  3. If a customer tries to open an expired HPP they will instantly be redirected to the Abort URL
  4. HPP are only reusable ("is_reusable": true) as long as the HPP hasn't expired

How to specify an expiration time?

There is a new property expiration_time for requests to the paymentPage.initialize RPC method.

In this example we're creating a payment page that is valid for 30 minutes (1800 seconds).

{
  "jsonrpc": "2.0",
  "method": "paymentPage.initialize",
  "params": {
    ...
    "expiration_time": 1800,
    ...
  },
  "id": 1
}

There are also a couple of new corresponding properties in responses of paymentPage.getDetails.

{
  "jsonrpc": "2.0",
  "result": {
    ...
    "is_expired": false,
    "expires_in": 1753,
    "expiration_time": 1800,
    ...
  },
  "id": 1
}

Back to the overview