Limiting time for using Payment Page

General information

When using Payment Page, you can set a limited period of time within which the customer can use the payment form to perform a targeted action. If the limited period of time is set, the remaining time is displayed on Payment Page until the customer confirms performance of the targeted action.

Limiting time for using Payment Page allows to control delivery of services to customers and, for instance, may be especially useful when selling tickets or goods.

In terms of payment processing, the customer may be required to submit additional payment information. In this case, as soon as the customer confirms performance of the targeted action, the countdown stops, and as the page for submission of additional data is displayed, the new countdown starts. The new countdown is set by default and is 30 minutes starting from the moment when the page for submitting additional data is displayed. For more information about providing additional data, see Submission of additional payment information.

Usage scenario

The basic usage scenario of performing payment within limited period of time by using Payment Page can be described as follows:

  1. In the merchant's web service the customer selects the option to pay for the order and is redirected to Payment Page. The remaining time for using the payment form is displayed on Payment Page in the mm:ss format.


  2. The customer specifies the details of the payment instrument, confirms the purchase processing and waits for the result. Performance of the targeted action is considered confirmed and the remaining time is not displayed on the subsequent pages of Payment Page.


    If the customer does not confirm performance of the targeted action before the remaining time expires, the page with notification about expiration of the specified period of time is displayed.



Request format

The format of the request for opening Payment Page to perform payment with the option of time limit for using the payment form is the same as the format described in the Interaction concepts section. To set then time limit for using the payment form, you need to additionally specify in the request for opening Payment Page the best_before parameter and its value in the YYYY-MM-DDThh:mm:ss±hh format.

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

    //the payment form can be used before 10:15:30 of 12 April 2021, GMT+3
   "best_before": "2021-04-12T10:15:30+03"  
 
}

Figure: Example of the request for opening Payment Page

https://paymentpage.ecommpay.com/payment?signature=TSzdE5rJZaA9TYAKoGpfXriFf82MxF...&payment_id=7654321777&payment_amount=131970&payment_currency=USD&project_id=42&customer_id=12&&language_code=en&best_before=2021-04-12T10%3A15%3A30%2B03