Stow Cards Wallet passes

Integrations

Connect Stow Cards to the tools you already use

A REST API and signed webhooks sit behind the console, so anything you can do by hand you can also automate or react to.

REST API

One API, the same gateway as the console

Award points, enroll members, or trigger a pass update from your own systems. Every write is authenticated with a scoped API key and every money-like write supports an Idempotency-Key, so a retried request never double-applies.

  • REST + JSON over HTTPS
  • API-key authentication, scoped to your merchant and its roles
  • Idempotent writes on points and balance changes
# Add points to a member and push the update to their wallet
curl -X PATCH https://api.stow.cards/api/v1/merchants/me/members/MEMBER_UUID/points \
  -H "X-API-Key: $STOW_API_KEY" \
  -H "Idempotency-Key: 018f3c2e-9d41-7c3a-b5e6-2f8d5b6a7c3d" \
  -H "Content-Type: application/json" \
  -d '{ "delta": 25, "changeMessage": "Thanks for your purchase!" }'

# 200 OK (abridged)
{
  "success": true,
  "data": {
    "member": { "id": "MEMBER_UUID", "memberCode": "7K2Q9FMRDC" },
    "previous": 265,
    "current": 290,
    "passUpdate": { "apple": { "devicesNotified": 1 } }
  }
}

MEMBER_UUID is the id the API returns when you enroll a member or search for their Member ID. It is not the Member ID printed on the pass.

Webhooks

React to what happens on your programs

Subscribe an HTTPS endpoint to any of 12 event types and Stow Cards POSTs a signed JSON payload the moment it happens, with automatic retries if your endpoint is briefly down.

  • HMAC-SHA256 signed, with a timestamp to reject replays
  • Retried on failure; every delivery is logged and replayable
  • Subscribe to specific events, or * for everything
member.created member.updated points.changed reward.redeemed pass.installed pass.scanned campaign.sent batch.completed pass.updated

How it works

Built for safe, repeatable calls

Scoped API keys

Each key is bound to one merchant and inherits the permissions of the roles you assign it. A till integration can award points; it cannot change billing or staff access.

Idempotent writes

Send the same Idempotency-Key twice and the adjustment applies once, so a dropped connection can be retried safely.

One gateway

The console, the scanner app, and the API all go through the same gateway, so behavior stays consistent everywhere.

Browse by category

Ways merchants connect Stow Cards

These are integration patterns the API and webhooks support, not a list of pre-built connectors. Talk to us about wiring up your specific stack.

Point of sale

POS and till systems

Call the points API from your checkout flow so rewards apply automatically on every sale, with no separate scan step.

Without code

Staff scan the pass with the Stow Cards Merchant app and add the points there.

Ecommerce

Checkout hooks

Award points or redeem a reward from your order-confirmation step, right after checkout completes.

Without code

Find the customer in the console and add points or redeem a reward by hand.

Booking & scheduling

Booking systems

Enroll a member and award a visit or a class credit the moment a booking is confirmed.

Without code

Put your sign-up link in booking confirmations, and scan the pass when they arrive.

CRM & customer data

Bulk member import

Bring an existing member list in from a CSV when you switch from a legacy program or spreadsheet.

Without code

Upload the CSV on the Members page of the console.

CRM & customer data

Sync members out

Subscribe to member.created and member.updated webhooks to keep your CRM current without polling.

Marketing & automation

Tag-based segmentation

Add or remove tags on a member from your own systems, then build a campaign segment around them in the console.

Without code

Tag members on their page in the console and build the segment there.

Marketing & automation

React to sent campaigns

Get a campaign.sent webhook when a send completes, and log it in your own marketing tools.

Without code

Each campaign in the console lists the members who received it.

Analytics & reporting

Export events & transactions

Pull a member's event timeline or transaction ledger as JSON or CSV for your own reporting.

Without code

Download the transactions ledger or a member’s timeline as CSV from the console.

Analytics & reporting

Stream wallet events

Subscribe to pass.scanned, pass.installed, and batch.completed to feed your analytics warehouse in near real time.

Without code

Follow scans, pass installs and sign-ups on the console’s dashboard and Analytics page.

Scanner & hardware

PWA scanner app

Use the Stow Cards Merchant app as a turnkey till device, or build your own reader against the same scan endpoint.

Identity & security

SSO on Scale

Federate staff sign-in with your identity provider and get an audit log of account and permission changes.

Something else?

Request an integration

Tell us which system you’d like Stow Cards to work with, and we’ll tell you whether the API and webhooks can connect it today.

Request an integration

Talk to us about your stack

Tell us what you're running today and we'll help you plan the integration.