The essentials
Example cases
Basic: issue points and validate rewards
The core loop — award points on every order, honor rewards at checkout. Start with this one.
Earn points on specific products or hours only
Your code decides which line items qualify (e.g. only coffee SKUs, only 2–5 pm) and sends Rigaly the qualifying amount.
Claim rewards on specific products only
Validate the code, check the cart against the reward’s conditions, then complete.
Mass codes for physical products
Print unique single-use codes on bottles, boxes, or receipts — you’re only charged when a code is redeemed.
Complete route list
Meta —GET /me
Points — POST /points/issue · POST /points/redeem
Customers — GET /customers/lookup · GET /customers/{userId}/balance · GET|POST /customers/{userId}/identifiers · PATCH|DELETE /customers/{userId}/identifiers/{id}
Rewards — GET|POST /rewards · GET|PATCH|DELETE /rewards/{id}
Redemptions — GET /redemptions/{code} · POST /redemptions/{code}/complete
Code batches — GET|POST /code-batches · GET /code-batches/{id} · GET /code-batches/{id}/export · POST /code-batches/{id}/deactivate · POST /code-batches/verify
Promotions — GET|POST /promotions · GET|PATCH|DELETE /promotions/{id}
Raffles — GET|POST /raffles · GET|PATCH|DELETE /raffles/{id} · POST /raffles/{id}/cancel · POST /raffles/{id}/end · GET /raffles/{id}/entries · GET /raffles/{id}/winners
Levels (tiers) — GET|POST /tiers · PATCH|DELETE /tiers/{id} · PATCH /tiers/settings · POST /tiers/reorder · GET|PUT /customers/{userId}/tier
Segments — GET /segments/presets · POST /segments/preview · POST /segments/customers
Transactions — GET /transactions (business-wide, filterable)
Devices — GET /devices (read-only)
Reviews — GET /reviews · GET /reviews/summary · GET|PUT|DELETE /reviews/questionnaire