Cancel Withdrawal Item

Requests cancellation of a single undelivered withdrawal item. AssetPay asks the marketplace supplier to cancel the purchase; on success your merchant wallet is refunded automatically. To cancel the whole order in one call, use POST /client/trading/withdraw/{tradeId}/cancel instead. Authentication: Client Token (Authorization header)

CS2 (Assetpay) items only. Rust withdrawals are fulfilled by a polling supplier with no cancel API, and autoseller-sourced items leave nothing to reverse upstream; both return TRADE_CANCEL_UNSUPPORTED (44).

Request

POST https://api.assetpay.gg/client/trading/withdraw/{tradeId}/items/{itemId}/cancel
Authorization: CLIENT_TOKEN

Path Parameters

Parameter	Type	Required	Description
`tradeId`	string	Yes	The withdrawal’s internal ID, or the `externalId` you supplied at creation.
`itemId`	string	Yes	The item’s `id` within that trade, or the per-item `externalId` you supplied at withdraw time. 1–128 chars.

When an item can be cancelled

A cancel is only accepted when all of the following hold:

The item belongs to a withdrawal trade owned by the authenticated user.
The item is a CS2 (Assetpay) item that was not sourced from the autoseller pool.
The item is at least 30 minutes old (measured from when it was created).
The item is not already in a terminal state (completed, failed, reverted, canceled).

Response

{
  "requestId": "...",
  "success": true,
  "data": {
    "tradeId": "trade-uuid",
    "itemId": "item-uuid",
    "externalId": "wd_item_a",
    "status": "cancelled"
  }
}

externalId echoes your own per-item reference and is omitted when you did not supply one. A 200 only confirms the marketplace accepted the cancellation. AssetPay does not change the item state inline — the refund and the transition to canceled arrive asynchronously through the standard trade.* callback. Poll GET /client/trades/{id} or rely on callbacks for the final state, and refund the user’s balance when you receive the canceled callback.

A cancel lands on canceled, not reverted. reverted is for a delivered item that came back afterwards.

Rate Limits

Merchant Status	Limit
Verified	60 requests / min
Unverified	10 requests / min

Shared across all clients of the same merchant.

Errors

Code	Key	When
27	`TRADE_CANCEL_TOO_SOON`	The item is younger than 30 minutes. Retry after the 30-minute window.
28	`TRADE_NOT_CANCELLABLE`	Not cancellable: not a withdrawal, already in a terminal state, or the marketplace rejected the cancel.
44	`TRADE_CANCEL_UNSUPPORTED`	The item is Rust or autoseller-sourced, so there is no supplier cancel to call.
1300	`FORBIDDEN`	The trade does not belong to the authenticated user.
2201	`ITEM_NOT_FOUND`	No item matching that `itemId` or `externalId` exists under the given trade.

Overview

Authentication

Client

Trading

Secure

Verification

Cancel Withdrawal Item

Request

Path Parameters

When an item can be cancelled

Response

Rate Limits

Errors

​Request

​Path Parameters

​When an item can be cancelled

​Response

​Rate Limits

​Errors

Request

Path Parameters

When an item can be cancelled

Response

Rate Limits

Errors