Skip to main content

Deleting Transactions

You can reomove a pending transaction that you have previously submitted. Note that:

  • You can only remove transactions that you have created
  • The transaction must be in the awaitingFunds state
  • You cannot remove transactions that are processing or completed

Example Request​

DELETE v1/transactions/txn_123
curl -X DELETE https://api.sphere.net/v1/transactions/txn_123 \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: <Unique Idempotency Key>'

Response​

{
  "ok": true,
  "object": "object",
  "statusCode": 200,
  "error": null,
  "message": "success",
  "data": {}
}

📘 Once a transaction has received funds or has started processing, it cannot be removed. This ensures the integrity of the network and prevents disruption to in-progress transactions.