Skip to main content

Cancel Crypto Withdraw

Deprecated

This endpoint is deprecated. Use POST /v3/crypto/withdrawals/{withdrawal_id}/cancel for a withdrawal created through v3; this endpoint refuses one with 409, and keeps cancelling the withdrawals created through v2. It keeps working for now, and its responses carry Deprecation: true and a Link header naming the v3 page; BlockWyre will tell you the date before it stops, from when it answers 410 Gone. See Crypto v3.

This endpoint cancels a crypto withdrawal transaction.

Technical Details​

  • Cancellation Window: Withdrawals can only be cancelled during the 5-minute grace period while the transaction status is pending.
  • Restrictions: Once the grace period expires and the transaction moves to processing (or any other status), it cannot be cancelled.
  • Withdrawals created through v3: answer 409 with the message withdrawal was created through /v3 and must be cancelled there: POST /v3/crypto/withdrawals/{withdrawal_id}/cancel. Cancel them with Cancel a Crypto Withdrawal.
  • Webhooks: This operation triggers the crypto_transaction_status_updated webhook with status cancelled.
Authorization:

Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.

Headers:
Authorization: APIKey {SIGNED_JWT}

How to build and sign the JWT: Authentication.

Endpoint

DELETE

/api/v2/crypto/withdraw/{withdrawalID}/cancel

Path Parameters​

ParameterTypeDescription
withdrawalIDuuidRequired. The ID of the withdrawal to cancel.

Response​

A successful response returns a 204 No Content status code.

Errors​

StatusMessageMeaning
404withdrawal_not_foundNo withdrawal has this ID.
409withdrawal was created through /v3 and must be cancelled there: POST /v3/crypto/withdrawals/{withdrawal_id}/cancelThe withdrawal was created through v3. Cancel it with Cancel a Crypto Withdrawal.

Support and Resources​

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated​

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!