Build on the Stow Cards API

Quickstart

Your first call

Send the key in an X-API-Key header. This call adds 25 points to a member. The reply gives the old and new balance and how many of the member’s iPhones accepted the update push.

• REST and JSON over HTTPS, through the same gateway as the console
• Each key is bound to your merchant and carries only the roles you give it
• An Idempotency-Key on points and redemptions, so a retry within 24 hours never applies twice
• Example clients in Node.js, Python, PHP, Ruby and Go, plus a curl script, run the same four calls end to end

# 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.