APICenter
DocsBuildLearn
APIs & SDKs/APICenter REST API/Cancel Checkout

Cancel Checkout

POSThttps://api.apicenter.itsandbox.site/api/v1/payments/checkouts/{checkoutId}/cancel

Perform Cancel Checkout operation on APICenter platform.

TShttps://api.apicenter.itsandbox.site/api/v1/payments/checkouts/{checkoutId}/cancel
// Replace the path placeholders with your resource identifiers.
const paymentApiKey = process.env.APICENTER_PAYMENT_API_KEY;
if (!paymentApiKey) throw new Error("APICENTER_PAYMENT_API_KEY is required");

const response = await fetch("https://api.apicenter.itsandbox.site/api/v1/payments/checkouts/{checkoutId}/cancel", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + paymentApiKey,
    "Idempotency-Key": "unique-key-cancelCheckout"
  }
});
if (!response.ok) throw new Error("APICenter request failed: " + response.status);
const data = await response.json();
console.log(data);
Response
No response example is supplied by this contract. See the documented response schema.

Authentication

AuthorizationAPICenterApiKey

Authorization: Bearer <PAYMENT_API_KEY>. Use the consumer's payment API key. or Registered APICenter service JWT with gateway-enforced scopes.

Path parameters

checkoutIdstringRequired

The unique checkoutId identifier.

Headers

Idempotency-KeystringRequired

Unique key for safely retrying this payment mutation. Reuse the same key and request body after uncertain outcomes. A key used with a different request, an in-progress request, or an unresolved provider outcome returns HTTP 409.

Response

200Checkout cancelled
successbooleanRequired
dataobjectRequired

Errors

409The key was used with a different request, is already processing, or the provider outcome remains unresolved. Inspect `error.code`; in particular, `PAYMENT_OUTCOME_UNKNOWN` requires reconciliation before using a new key.
TShttps://api.apicenter.itsandbox.site/api/v1/payments/checkouts/{checkoutId}/cancel
// Replace the path placeholders with your resource identifiers.
const paymentApiKey = process.env.APICENTER_PAYMENT_API_KEY;
if (!paymentApiKey) throw new Error("APICENTER_PAYMENT_API_KEY is required");

const response = await fetch("https://api.apicenter.itsandbox.site/api/v1/payments/checkouts/{checkoutId}/cancel", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + paymentApiKey,
    "Idempotency-Key": "unique-key-cancelCheckout"
  }
});
if (!response.ok) throw new Error("APICenter request failed: " + response.status);
const data = await response.json();
console.log(data);
Response
No response example is supplied by this contract. See the documented response schema.