Change expiration date

Once a hold token is created, you can change its validity period.

A good use case would be a reservation wizard, in which a user first has 15 minutes to select his seats, and then another 30 minutes to complete payment. In that case, it makes sense to change the token to expire in 30 minutes from now when the ticket buyer arrives at the payment page.

If you pass in 0, the token expires immediately.

Note that the total maximum validity of a hold token is 2 hours. That means that a token that was created 10 minutes ago can at most be valid for another 1h50m.

POST https://api-{region}{token}

To change the expiration date of hold token, send a POST to https://api-{region}{token}. The request body must be a JSON object containing an expiresInMinutes property:

expiresInMinutes: 30
curl -X POST https://api-{region} \
-u aSecretKey: \
-H "Content-Type: application/json" \
-d "{'expiresInMinutes': 30}"
"holdToken": "wvXbB9MlHt",
"expiresAt": "2017-05-05T10:58:44.715Z",
"expiresInSeconds": 768