Cancel Order | Transak | Documentation

curl -X DELETE "https://api-gateway-stg.transak.com/api/v2/orders/467b702d-81c4-4f05-aff2-31ef7ebcc83c?cancelReason=User%20requested%20cancellation" \
     -H "authorization: USER_AUTHORIZATION_TOKEN" \
     -H "x-user-identifier: USER_EMAIL_ID" \
     -H "x-access-token: YOUR_ACCESS_TOKEN"

{
  "data": {
    "orderId": "467b702d-81c4-4f05-aff2-31ef7ebcc83c",
    "walletAddress": "0x8eeF3b6905704BdbB936f89dcd1A8BFE1B581405",
    "status": "CANCELLED",
    "fiatCurrency": "EUR",
    "partnerUserId": "269b0f29-b5ec-42bb-acea-2b89c15b2505",
    "cryptoCurrency": "ETH",
    "isBuyOrSell": "BUY",
    "fiatAmount": 41,
    "ipAddress": "13.41.170.70",
    "amountPaid": 0,
    "paymentMethod": "sepa_bank_transfer",
    "walletLink": "https://sepolia.etherscan.io/address/0x8eeF3b6905704BdbB936f89dcd1A8BFE1B581405",
    "quoteId": "c2f81dfc-77b7-4a2f-a906-610202240c3c",
    "orderProcessingType": "NORMAL",
    "addressAdditionalData": false,
    "network": "ethereum",
    "conversionPrice": 0.0006888910117672325,
    "cryptoAmount": 0.02755564,
    "totalFeeInFiat": 1,
    "fiatAmountInUsd": 44.99,
    "countryCode": "IN",
    "paymentDetails": [
      {
        "currency": "EUR",
        "id": "sepa_bank_transfer",
        "name": "Bank Transfer Details",
        "fields": [
          {
            "name": "Account Type",
            "value": "Personal"
          },
          {
            "name": "Amount",
            "value": "41 EUR"
          },
          {
            "name": "First Name (Beneficiary)",
            "value": "shashi"
          },
          {
            "name": "Last Name (Beneficiary)",
            "value": "shekhar"
          },
          {
            "name": "IBAN",
            "value": "GB07SEOU19870010350545"
          },
          {
            "name": "Bank Name",
            "value": "Simulator Bank"
          },
          {
            "name": "Bank Country",
            "value": "Malta"
          },
          {
            "name": "Bank Address",
            "value": "The Bower, 207-211 Old Street, London, England, EC1V 9NR"
          }
        ]
      }
    ],
    "autoExpiresAt": "2025-04-08T04:48:10+00:00",
    "campaignAmount": 0,
    "campaignAmountInUsd": 0,
    "tfPerOff": 0,
    "aTtlFees": 1,
    "aTskFees": 1,
    "stateCode": "karnataka",
    "orderChannelType": "WIDGET",
    "tokenContractAddress": "0x0000000000000000000000000000000000000000",
    "userKycType": "STANDARD",
    "cardPaymentData": {
      "orderId": "467b702d-81c4-4f05-aff2-31ef7ebcc83c",
      "paymentId": "67f4a0008ff577a6bcfbcbe9",
      "pgData": {
        "liquidityProvider": "OPENPAYD_MALTA",
        "status": "CREATED",
        "beneficiaryName": "shashi shekhar",
        "paymentOptions": [
          {
            "currency": "EUR",
            "id": "sepa_bank_transfer",
            "name": "Bank Transfer Details",
            "fields": [
              {
                "name": "Account Type",
                "value": "Personal"
              },
              {
                "name": "Amount",
                "value": "41 EUR"
              },
              {
                "name": "First Name (Beneficiary)",
                "value": "shashi"
              },
              {
                "name": "Last Name (Beneficiary)",
                "value": "shekhar"
              },
              {
                "name": "IBAN",
                "value": "GB07SEOU19870010350545"
              },
              {
                "name": "Bank Name",
                "value": "Simulator Bank"
              },
              {
                "name": "Bank Country",
                "value": "Malta"
              },
              {
                "name": "Bank Address",
                "value": "The Bower, 207-211 Old Street, London, England, EC1V 9NR"
              }
            ]
          }
        ]
      },
      "liquidityProvider": "OPENPAYD_MALTA",
      "updatedAt": "2025-04-08T04:03:12.469Z"
    },
    "lastNotifiedAt": "2025-04-08T04:03:18.869Z",
    "cancelReason": "cancel"
  }
}

The Cancel Order is an authenticated API that allows users to cancel an existing order before payment is completed. This API is useful for cases where users change their mind, enter incorrect details, or experience payment issues. Once an order is successfully canceled, it cannot be reversed, and a new order must be placed.

The **Cancel Order** is an **authenticated API** that allows users to **cancel an existing order** before payment is completed. This API is useful for cases where **users change their mind, enter incorrect details, or experience payment issues**. Once an order is **successfully canceled**, it cannot be **reversed**, and a new order must be placed.

Path parameters

orderidstringRequiredDefaults to 467b702d-81c4-4f05-aff2-31ef7ebcc83c

orderId is the id received from the API - api/v2/orders

Headers

Query parameters

cancelReasonstringRequiredDefaults to User requested cancellation

Reason to Cancel the order

Response

200 - Success

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error