Cancel a checkout

Close a checkout the customer is leaving, before any funds are on the way.

For a customer who leaves without paying. Public, like creating a checkout: the checkout's ID is all it takes. Called with your secret key, the response also has email, reporting and fee_rate_bps.

Works while the checkout is open or awaiting_customer. It becomes canceled with canceled_by set to customer. The secure payment page of a card attempt isn't closed, though: a payment the customer still finishes there reaches you in needs_review, and you receive payment.needs_review. Canceling twice returns the checkout as it is.

What happens to the payment depends on where it came from. A link's payment fails, with a failed event whose reason is canceled, and you receive payment.failed. A payment you created through the API stays pending, so the customer can come back and try again until it expires. On a remainder checkout, what already arrived stays with the payment.

A customer who paid anyway can report the transfer with a claim.

Path

id string Required

The checkout's ID, such as chk_8zXVc2SbCBDho78Q.

Errors

404 not_found

No checkout has that ID.
409 checkout_not_cancelable

The checkout isn't open or awaiting_customer: funds may already be on the way, or it has ended.

Any request can also fail on its key or its body. See errors.

Request

curl -X POST "https://api.402pay.co/api/v1/checkouts/chk_8zXVc2SbCBDho78Q/cancel"

const response = await fetch("https://api.402pay.co/api/v1/checkouts/chk_8zXVc2SbCBDho78Q/cancel", {
  method: "POST",
});
const { data } = await response.json();

import requests

response = requests.post(
    "https://api.402pay.co/api/v1/checkouts/chk_8zXVc2SbCBDho78Q/cancel",
)
data = response.json()["data"]

Response200 OK

{
  "data": {
    "id": "chk_8zXVc2SbCBDho78Q",
    "kind": "checkout",
    "status": "canceled",
    "rail": "crypto",
    "link_id": null,
    "payment_id": "pmt_pxYW5vHfVt1xTIT2",
    "amount": "49.00",
    "currency": "USD",
    "breakdown": {
      "currency": "USD",
      "price": "49.00",
      "processing_fee": null,
      "network_fee": "0.90",
      "total": "49.90"
    },
    "crypto": {
      "asset": "USDC",
      "network": "ethereum",
      "amount": "49.00",
      "address": "0xB82AFd9E40ED990A37c7eeB43e8d04528732ef39",
      "payment_uri": "ethereum:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48@1/transfer?address=0xB82AFd9E40ED990A37c7eeB43e8d04528732ef39&uint256=49000000",
      "rate": {
        "amount": "1.00",
        "currency": "USD"
      },
      "received_amount": "0.00",
      "remaining_amount": null,
      "remaining_payment_uri": null,
      "overpaid_amount": null,
      "detected_network": null,
      "tx_hash": null,
      "explorer_url": null
    },
    "card": null,
    "confirmations": {
      "current": 0,
      "required": 2
    },
    "remainder": false,
    "canceled_by": "customer",
    "replaced_by": null,
    "failure_code": null,
    "review_reason": null,
    "success_url": "https://example.com/thanks",
    "expires_at": "2026-09-27T18:27:57.906Z",
    "sent_at": null,
    "created_at": "2026-09-27T18:12:57.906Z",
    "updated_at": "2026-09-27T18:12:57.975Z"
  }
}