Cancel a Session | CrissCross

If a transaction on the session is being processed by a provider that does not support cancelling an in-progress transaction, the session enters the PENDING_CANCELLATION state instead of CANCELLED. While in this state, no further payment attempts can be initiated against the session, but the session is not considered fully cancelled until the in-flight transaction reaches a terminal state on its own. The response will list the unstoppable transactions in pendingTransactionIds.

Cancels a checkout session. The session is locked against any further payment attempts, and every in-flight (non-terminal) transaction linked to the session is cancelled in the same call. Transactions that have already reached a terminal state (settled, failed, refunded) are not affected. If a transaction on the session is being processed by a provider that does not support cancelling an in-progress transaction, the session enters the **`PENDING_CANCELLATION`** state instead of `CANCELLED`. While in this state, no further payment attempts can be initiated against the session, but the session is not considered fully cancelled until the in-flight transaction reaches a terminal state on its own. The response will list the unstoppable transactions in `pendingTransactionIds`.

Request

This endpoint expects an object.

sessionIdstringRequiredformat: "uuid"

Identifier of the checkout session to cancel. UUID v7.

reasonstringOptional

Optional free-form reason for the cancellation, recorded for reporting.

Response

Session cancellation accepted.

sessionIdstringformat: "uuid"

Identifier of the session that was cancelled. UUID v7.

statusenum

The resulting state of the session. CANCELLED indicates the session and all of its in-flight transactions have been cancelled. PENDING_CANCELLATION indicates the session is locked against further payment attempts, but at least one in-flight transaction belongs to a provider that does not support in-process cancellation — the session will move to CANCELLED once those transactions reach a terminal state.

messagestring

Human-readable status message.

cancelledTransactionIdslist of strings

Transactions on the session that were cancelled as part of this call. UUID v7.

pendingTransactionIdslist of strings

Transactions still in flight that could not be cancelled because their provider does not support in-process cancellation. Populated only when status is PENDING_CANCELLATION. Each entry will progress to its own terminal state independently. UUID v7.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

$	curl -X POST https://api.crisscross.money/v1/checkout/session/cancel \
>	-H "Content-Type: application/json" \
>	-d '{
>	"sessionId": "01951c8a-7c3d-7e1f-9d4a-2b3c4d5e6f70",
>	"reason": "Customer abandoned checkout"
>	}'

1	{
2	"sessionId": "01951c8a-7c3d-7e1f-9d4a-2b3c4d5e6f70",
3	"status": "CANCELLED",
4	"message": "Session cancelled. 1 in-flight transaction was cancelled as part of this call.",
5	"cancelledTransactionIds": [
6	"01951c8a-8b4c-7d2a-8f1e-5d6c7b8a9e10"
7	],
8	"pendingTransactionIds": []
9	}