Send your first event in 5 minutes

The StickyTier API runs loyalty, tiers and referrals for any commerce stack — WooCommerce, Magento, a custom cart, or your POS. You send commerce events; we keep an append-only rewards ledger, apply your program's rules, and expose balances, redemptions and webhooks.

1 · Get a test key

In the admin, open Developers → Create an API key, keep mode Test, and copy the key (shown once). Test keys write to an isolated sandbox — nothing touches your production program, and you can wipe the sandbox anytime.

2 · Verify it

curl

curl https://stickytier.com/v1/ping \
  -H "Authorization: Bearer sticky_test_YOUR_KEY"

# → { "data": { "pong": true, "mode": "test", "scopes": ["ingest","read"] } }

3 · Send an order

curl — a paid ₹499 order

curl -X POST https://stickytier.com/v1/events \
  -H "Authorization: Bearer sticky_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "order.paid",
    "order_ref": "ORDER-1001",
    "email": "customer@example.com",
    "gross_cents": 49900
  }'

# → 202 { "data": { "id": "…", "status": "queued", "replayed": false } }

Processing is asynchronous (usually <1s). The customer is enrolled automatically, your active earning rules run — caps, budgets and timing included — and the resulting ledger entries attach to the event.

4 · Watch the points land

curl — event status, then the member

curl https://stickytier.com/v1/events/EVENT_ID \
  -H "Authorization: Bearer sticky_test_YOUR_KEY"
# → { "data": { "status": "completed", "ledger_entry_ids": ["…"] } }

curl "https://stickytier.com/v1/members?email=customer@example.com" \
  -H "Authorization: Bearer sticky_test_YOUR_KEY"
# → balances.available_cents / pending_cents per your rule timing

5 · Redeem

curl — voucher your POS can honor

curl -X POST https://stickytier.com/v1/members/MEMBER_ID/redemptions \
  -H "Authorization: Bearer sticky_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amount_cents": 5000 }'
# → 201 { "data": { "code": "RWD-XXXX-XXXX", "status": "created", … } }

# When the customer uses it at your counter/cart:
curl -X POST https://stickytier.com/v1/redemptions/REDEMPTION_ID/confirm \
  -H "Authorization: Bearer sticky_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "order_ref": "ORDER-1002" }'

Didn't use it? /void restores the value instantly — and unconfirmed vouchers auto-void after your program's TTL, so customers never lose points to an abandoned checkout.

Next steps

Read the auth, idempotency, pagination and error guides, subscribe to webhooks, or explore every endpoint in the API reference. When you're ready, create a live key and switch the base key — the API surface is identical.