Timeouts

After you initiate a transaction, a timeout will occur automatically when either:

• An issuer does not process a transaction within 120 seconds. This is a processing timeout.
• A terminal has been waiting for shopper interaction for too long. This is a device timeout.

Processing timeout

When a shopper has verified a transaction on a terminal (for example, by entering a PIN or signature), the payment is sent for processing. If the issuer has not processed this transaction within 120 seconds, the Adyen payments platform will automatically cancel the transaction.

When a processing timeout occurs:

• Declined is displayed on the terminal screen.

• You receive a payment result containing:

  • PaymentResponse.Response.Result: Failure
  • PaymentResponse.Response.ErrorCondition: Communication timeout

  The example payment result below indicates the transaction was cancelled due to a processing timeout.

  {
    "SaleToPOIResponse":{
      "MessageHeader":{...},
      "PaymentResponse":{
        ...
        },
        "Response":{
          ...
          "Result":"Failure",
          "ErrorCondition":"Communication timeout"
        },
        ...
      }
    }
  }

In case of a processing timeout, attempt the transaction again using an alternative card or payment method (if possible).

Device timeout

When a terminal is waiting for an interaction for too long, the transaction will time out. This results in the transaction being cancelled.

Here we describe terminal prompts that will eventually time out, as well as:

• Timeout (sec): The duration the prompt is displayed on the terminal before the transaction times out.
• Configurable: Whether the timeout duration is configurable. To configure a timeout duration, contact our POS Support Team.

Prompt	Timeout (sec)	Configurable
Amount confirmation	300
Insert, swipe, or tap card	120
Application selection	120
Currency conversion acknowledgement	120
PIN entry	60
Signature capture	60
Signature check	900
Manual card number entry	60
Manual expiry date entry	60
Authorization in progress	200
Receipt printing confirmation	120

When a device timeout occurs, you receive a payment result containing:

• PaymentResponse.Response.Result: Failure
• PaymentResponse.Response.ErrorCondition: Cancel

The example payment result below indicates a device timeout.

{
    "SaleToPOIResponse": {
        "PaymentResponse": {
            "POIData": {...},
            "PaymentResult": {...},
            "Response": {
                "Result": "Failure",
                "AdditionalResponse": "...",
                "ErrorCondition": "Cancel"
            }
        },
        "MessageHeader": {
            "SaleID": "POSSystemID12345",
            "MessageClass": "Service",
            "MessageCategory": "Payment",
            "ServiceID": "0207111104",
            "POIID": "V400m-324688179",
            "MessageType": "Response"
        }
    }
}

When a transaction is cancelled due to a device timeout, you should attempt the transaction again.

See also