Delivery checkouts

Release a checkout lock

Requires checkouts:write. Release the lock only after confirming that the payment or order attempt failed. This invalidates the lock and clears the saved selection. Do not release it while the outcome is unknown or after the order has been accepted.

post/api/external/v1/checkouts/{token}/release

Request

  • Base URL: http://localhost
  • URL: http://localhost/api/external/v1/checkouts/{token}/release
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Request body

expected_revisioninteger required

Revision from the latest checkout response. A stale revision returns 409; read current state before retrying. Must be at least 1. Must not be greater than 2147483647.

lock_idstring required

ID of the lock to release. Release only after confirming that the payment or order attempt failed. Must start with one of <code>lock_</code> Must not be greater than 64 characters.

Example request

{
  "expected_revision": 4,
  "lock_id": "lock_example"
}

Response

Example response

{
  "data": {
    "checkout_token": "chk_AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPp",
    "status": "open",
    "revision": 4,
    "currency": "SEK",
    "locale": "en",
    "ready": false,
    "expires_at": "2026-09-14T12:10:00+00:00",
    "quote": null,
    "selection": null,
    "lock": null,
    "order": null
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.