trovy developers

Put Trovy's loyalty engine behind your own checkout

You take the payment. Trovy tracks the rewards and sends the texts. Eight endpoints, a typed SDK, and a sandbox with its own keys.

Quickstart API reference

Start here

Quickstart — five calls, from nothing to a reward redeemed.
Authentication — two kinds of key, and where each belongs.
Idempotency and retries — pass your own order id; a retry can never earn twice.
Customers and the widget — how someone joins without your site touching a phone number.

The surface

Business

GET/v1/businessYour business and its active rewards program
GET/v1/storesYour locations

Customers

POST/v1/customers/linkExchange a sign-up widget token for a customer id
POST/v1/customers/lookupFind a member of your business by phone number

Rewards

GET/v1/customers/{id}/rewardsA customer's rewards waiting to be redeemed
POST/v1/earnRecord an order and earn the customer a reward
POST/v1/redeemApply a customer's reward to an order
POST/v1/refundsRecord a refund and adjust the reward it earned