Add stamps

curl https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/stamps \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 3c8e1f2a-9b7d-4e6c-a1f0-5d2b8c7e9a14" \
  -H "Content-Type: application/json" \
  -d '{ "add": 1, "notificationMode": "notify" }'

{
  "pass": {
    "object": "pass",
    "id": "pass_7hGk2LmQ9xVt4RnB8cYe",
    "status": "active",
    "fieldValues": { "memberNumber": "BB-00284" },
    "stamps": { "count": 7, "total": 10 },
    "updatedAt": "2026-10-23T10:30:00.000Z"
  },
  "update": {
    "object": "pass_update",
    "id": "pupd_Qm7Xv2Lt9Nr4Kz8Pw3Bc",
    "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
    "notificationMode": "notify",
    "walletChanged": true,
    "changes": {
      "fields": [],
      "stamps": { "from": 6, "to": 7, "total": 10 }
    },
    "delivery": {
      "apple": { "status": "pending", "devices": 1, "error": null },
      "google": { "status": "pending", "message": "pending", "error": null }
    },
    "createdAt": "2026-10-23T10:30:00.000Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "message": "Only stamp card passes have stamps."
  },
  "requestId": "req_8f3a2c1d9e7b6a54"
}

POST

passes

{id}

stamps

curl https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/stamps \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 3c8e1f2a-9b7d-4e6c-a1f0-5d2b8c7e9a14" \
  -H "Content-Type: application/json" \
  -d '{ "add": 1, "notificationMode": "notify" }'

{
  "pass": {
    "object": "pass",
    "id": "pass_7hGk2LmQ9xVt4RnB8cYe",
    "status": "active",
    "fieldValues": { "memberNumber": "BB-00284" },
    "stamps": { "count": 7, "total": 10 },
    "updatedAt": "2026-10-23T10:30:00.000Z"
  },
  "update": {
    "object": "pass_update",
    "id": "pupd_Qm7Xv2Lt9Nr4Kz8Pw3Bc",
    "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
    "notificationMode": "notify",
    "walletChanged": true,
    "changes": {
      "fields": [],
      "stamps": { "from": 6, "to": 7, "total": 10 }
    },
    "delivery": {
      "apple": { "status": "pending", "devices": 1, "error": null },
      "google": { "status": "pending", "message": "pending", "error": null }
    },
    "createdAt": "2026-10-23T10:30:00.000Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "message": "Only stamp card passes have stamps."
  },
  "requestId": "req_8f3a2c1d9e7b6a54"
}

TapAce adds add to the pass’s current count, so two requests at the same time both count. The count never goes below 0 or above the card’s total: adding to a full card leaves it full. To set an exact count instead, send stamps to Update a pass. See Stamp cards.

string

required

The pass ID. The pass must be an active stamp card.

string

required

A unique value for this change, so a retry never adds the stamp twice. See Idempotency.

integer

required

How many stamps to add, from 1 to 10. A negative number, down to -10, removes stamps.

string

default:"silent"

silent updates the pass quietly. notify also shows the template’s stamp message on the holder’s lock screen, or its card-full message when this fills the card. See When the card fills.

Response

object

The updated pass. stamps.count is the new count.

object | null

A record of the change, as in Update a pass, with changes.stamps holding the from and to counts and the card’s total. It’s null when the count didn’t move, for example when adding to a full card.

Errors

Status	When
`400`	`add` is 0 or outside -10 to 10, the pass isn’t a stamp card, or the pass is voided.
`404`	The pass doesn’t exist.
`409`	The pass kept changing while the stamps were being added. Retry the request.

curl https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/stamps \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 3c8e1f2a-9b7d-4e6c-a1f0-5d2b8c7e9a14" \
  -H "Content-Type: application/json" \
  -d '{ "add": 1, "notificationMode": "notify" }'

{
  "pass": {
    "object": "pass",
    "id": "pass_7hGk2LmQ9xVt4RnB8cYe",
    "status": "active",
    "fieldValues": { "memberNumber": "BB-00284" },
    "stamps": { "count": 7, "total": 10 },
    "updatedAt": "2026-10-23T10:30:00.000Z"
  },
  "update": {
    "object": "pass_update",
    "id": "pupd_Qm7Xv2Lt9Nr4Kz8Pw3Bc",
    "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
    "notificationMode": "notify",
    "walletChanged": true,
    "changes": {
      "fields": [],
      "stamps": { "from": 6, "to": 7, "total": 10 }
    },
    "delivery": {
      "apple": { "status": "pending", "devices": 1, "error": null },
      "google": { "status": "pending", "message": "pending", "error": null }
    },
    "createdAt": "2026-10-23T10:30:00.000Z"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "message": "Only stamp card passes have stamps."
  },
  "requestId": "req_8f3a2c1d9e7b6a54"
}

Getting started

Basics

Guides

Node.js SDK

API keys

Passes

Loyalty cards

Notifications

Templates

Wallet signing

Deployments

Assets

Response

Errors

​Response

​Errors

Response

Errors