Limiting time for working with payment form

Overview

During the work with Payment Page, it is possible to specify the date and time until which the customer can work with the payment form to confirm the targeted action. This capability allows to control providing services to customers with regard to time and can be especially relevant in sales of tickets or clearance sales of goods. This data is specified in requests for opening Payment Page—in this case the payment form pages contain an additional panel that displays:

The date and time allocated for working with the payment form are specified in requests for opening Payment Page, and for setting up this capability, there are no additional actions required. If the restriction is set, the Payment Page pages contain an additional information panel that displays:

  • the information about the time when the work with the form is set to be completed, in the format of hh:mm;
  • the information about the time that remains until the completion of the work with the form, with the use of the timer mm:ss;
  • the indicator that counts down the final five minutes of the whole time allocated for working with Payment Page.

Usage scenario

On the customer side, purchase processing with the limited time of working with Payment Page looks as follows:

  1. On the merchant web service side, the customer confirms the purchase of the order and is redirected to the payment form.
  2. The customer performs the actions required for making the purchase and receives the result information.

    In case if the customer does not confirm the targeted action until the allocated time expires, the customer is notified about the time expiration on the next page of the payment form.

Figure 1. 1 — Opening payment form


Figure 2. 2 a — Processing purchase


Figure 3. 2 b — Declining purchase due to time expiration


Special aspects

When using the capability of limiting the time of the work with Payment Page, consider the following aspects:

  • During the processing of separate payments, payment systems or providers can require additional customer data—this can increase the time of working with the form (details).
  • The time allocated for working with the form within a separate payment is also relevant for making all retry attempts within this payment, regardless of their number (details).
  • When necessary, it is possible to add and use customised text elements for informing customers about the remaining time of working with the form (details).

Request format

For specifying the time within which the customer can work with the form, the request for opening Payment Page should contain the date, time, and time zone in the format of YYYY-MM-DDThh:mm:ss±hh specified in the best_before parameter.

{  
    // required parameters for purchase processing
   "project_id": 42,
   "payment_id": "7654321777",
   "payment_currency": "USD",
   "payment_amount": 131970,
   "customer_id": "customer_12",
   "signature": "TSzdE5rJZaA9TYAKoGpfXriFf82MxF...",

    // date and time when the work with the payment form is set to be completed—
    // 12 April 2021 10:15:30, GMT+3
   "best_before": "2021-04-12T10:15:30+03"  
 
}