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.
Ship rewards or deliver them digitally
Rewards don’t have to be collected at a counter — ship them, or hand over a code or link instantly. Plus redemption caps for limited stock.
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 · GET /redemptions (shipping queue) · PATCH /redemptions/{id}/fulfillment
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|POST /devices · PATCH|DELETE /devices/{id} · POST /devices/{id}/force-logout · POST /devices/{id}/pairing-qr · GET /devices/{id}/transactions
Reviews — GET /reviews · GET /reviews/summary · GET|PUT|DELETE /reviews/questionnaire