POST /secure/buy//items//cancel
Merchant-facing equivalent of POST /client/trading/withdraw/{tradeId}/items/{itemId}/cancel. Requests cancellation of a single undelivered item from one of your own self-trade buys. AssetPay asks the marketplace supplier to cancel the purchase; on success your merchant wallet is refunded automatically.
Authentication: Merchant API Key (api-key header)
Scope: CORE_ACCESS
CS2 (Assetpay) items only. Rust buys are fulfilled by a polling supplier with no cancel API and cannot be cancelled. Only self-trade buys (source: "self") are cancellable through this endpoint.
Request
POST https://api.assetpay.gg/secure/buy/{tradeId}/items/{itemId}/cancel
api-key: ap_...
Path Parameters
| Parameter | Type | Required | Description |
|---|
tradeId | string | Yes | The buy trade’s internal ID, or the externalId you supplied at creation. |
itemId | string (uuid) | Yes | The item’s ID within that trade (the id of an entry in the trade’s items array). |
When an item can be cancelled
A cancel is only accepted when all of the following hold:
- The item belongs to a self-trade (
source: "self") buy owned by the authenticated merchant.
- The item is a CS2 (Assetpay) item.
- 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",
"status": "cancelled"
}
}
200 only confirms the marketplace accepted the cancellation. AssetPay does not change the item state inline — the refund and the transition to reverted arrive asynchronously through the standard trade.* callback. Poll GET /secure/trades/{tradeId} or rely on callbacks for the final state.
Rate Limits
| Merchant Status | Limit |
|---|
| Verified | 60 requests / min |
| Unverified | 10 requests / min |
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, not a CS2/Assetpay item, already in a terminal state, or the marketplace rejected the cancel. |
| 1300 | FORBIDDEN | The trade is not a self-trade owned by the authenticated merchant. |
| 2201 | ITEM_NOT_FOUND | No item with that itemId exists under the given tradeId. |
