Delete a pass

curl -X DELETE https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 9a2c7e1b-4f3d-4b8a-8e6c-2d1f5a9b3c70"

{
  "object": "pass_erasure",
  "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
  "environment": "live"
}

{
  "error": {
    "type": "not_found_error",
    "message": "Pass not found."
  },
  "requestId": "req_8f3a2c1d9e7b6a54"
}

DELETE

passes

{id}

curl -X DELETE https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 9a2c7e1b-4f3d-4b8a-8e6c-2d1f5a9b3c70"

{
  "object": "pass_erasure",
  "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
  "environment": "live"
}

{
  "error": {
    "type": "not_found_error",
    "message": "Pass not found."
  },
  "requestId": "req_8f3a2c1d9e7b6a54"
}

Deleting is final and takes effect at once. The API and the dashboard stop returning the pass, its link stops working, and you stop receiving webhooks for it. An active pass is voided first, so the holder’s wallet shows it as void. The pass stays on the holder’s phone until they remove it.

string

required

The pass ID.

string

required

A unique value for this request.

Response

string

Always pass_erasure.

string

The deleted pass.

string

test or live, from your API key.

What happens to the data

TapAce keeps the record for 30 days so phones that were offline can still receive the void, then removes it along with the pass’s history. A pass with a wallet update still being delivered is removed once that finishes. Google Wallet has no delete, so its copy of the pass stays inactive.

Errors

Status	When
`404`	The pass doesn’t exist or was already deleted.

curl -X DELETE https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 9a2c7e1b-4f3d-4b8a-8e6c-2d1f5a9b3c70"

{
  "object": "pass_erasure",
  "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
  "environment": "live"
}

{
  "error": {
    "type": "not_found_error",
    "message": "Pass not found."
  },
  "requestId": "req_8f3a2c1d9e7b6a54"
}

Getting started

Basics

Guides

Node.js SDK

API keys

Passes

Loyalty cards

Notifications

Templates

Wallet signing

Deployments

Assets

Response

What happens to the data

Errors

​Response

​What happens to the data

​Errors

Response

What happens to the data

Errors