Skip to content
  • There are no suggestions because the search field is empty.

Checkout Cancellation

To prevent potential double charges, a Checkout Cancellation mechanism has been implemented. This feature allows a merchant's integration to explicitly terminate an active checkout session, especially in scenarios where a user closes the payment modal while a payment is pending.

When a cancellation is requested, Checkout stops the workflow, performs necessary compensation logic (like voiding transactions), and updates the session status.

API Endpoint

A new endpoint is available to request the cancellation of an active checkout session:

POST /checkouts/{intentUUID}/cancel

  • Purpose: Explicitly terminate an active checkout session.
    • intentUUID (string, required): The unique identifier for the checkout session (intent) you wish to cancel.
  • Authentication: This endpoint requires authentication and authorisation
  • Request Body: No request body is required.

API Responses

The endpoint will return one of the following API responses:

  • 202 Accepted: The cancellation request has been accepted, and the workflow termination has been successfully initiated.
  • 400 Failed: The session that is trying to be canceled is not in the ‘active’ or ‘inprogress’ status.
  • 404 Not Found: The specified intentUUID does not correspond to an active session.

To use this new endpoint, you must add a new permission to your Access Token: checkouts:cancel.