Cancel a partner transaction safely with idempotent retries

Cancels a partner transaction when the current state allows cancellation. Reuse the same Idempotency-Key for retries of the same cancellation intent.

POST /partner/transactions/{id}/cancel

Cancel a partner transaction safely with idempotent retries

cURL

curl --request POST \
  --url https://dev.cashweb.cash/api/v1/partner/transactions/{id}/cancel \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-API-KEY: <api-key>'

200

{
  "data": {
    "amount": "161500.00",
    "crypto_amount": "100.00",
    "crypto_currency": "usdt",
    "deposit_address": "TUr4xexampleaddress",
    "expires_at": "2026-02-12T12:00:00Z",
    "id": "01917f00-7b4c-7f56-8a2b-15998d58c9f3",
    "merchant_id": "mrc_001",
    "merchant_reference": "order-4551",
    "network": "trc20",
    "rate": "1615.00",
    "status": "cancelled",
    "terminal_id": "term_01"
  },
  "message": "Transaction cancelled",
  "success": true
}

Authorizations

X-API-KEY · string · header · required

Headers

Idempotency-Key · string · required

Idempotency key for safe retries

Path Parameters

id · string<uuid> · required

Partner transaction identifier

Response

200

application/json

Transaction cancelled

Standard API response wrapper for all successful responses

data · object · required

Partner transaction snapshot returned by create and cancel endpoints.

Show child attributes

success · boolean · required

Indicates if the request was successful

Example:

"true"

message · string | null

Optional message for additional information