Perkss
Sign in
MCP for agents · coming soon

Customer retention for developers and agents

Everything your technical team needs to ship a production loyalty program in an afternoon.

Read the docs
Install the SDK
$npm i @perkss/sdk
Questions?
Over 110+ brands and technical teams trust Perkss.
Quickstart

Live in a single call.

Members start earning the moment it's live.Read the quickstart

quickstart.tsCopy
$ npm i @perkss/sdk
import { PerkssApiClient } from "@perkss/sdk";
const client = new PerkssApiClient({ api_key: "YOUR_API_KEY" });
await client.auth.getToken({
grantType: "client_credentials"
});
$
200 · token.issued68 ms
Built for

Technical teams who obsess over their product.

DTC brands, retailers, fashion labels, studios, jewelers, opticians, pharmacies, restaurants, and hotels run retention on Perkss.

Perkss · DTC
DTC brands
Perkss · Retail
Retailers
Perkss · Wellness
Wellness
Perkss · Fashion
Fashion
Perkss · Jewelry
Jewelry
Perkss · Automotive
Car dealers & Automotive
Perkss · Eyewear
Eyewear
Perkss · F&B
Food & beverage
Perkss · Pharmacy
Pharmacies
Perkss · Hospitality
Hospitality
Book a demo
Developer experience

Everything through one API

From enrollment to redemption, every retention operation is a single typed call.

enroll.tsCopy
1import { PerkssApiClient } from "@perkss/sdk";
2
3const client = new PerkssApiClient();
4const newCustomer = await client.customers.create({
5 firstName: "Ada",
6 lastName: "Lovelace",
7 email: "ada@example.com",
8 phone: "+34600000000"
9});
201 · customer.created84 ms
Building blocks

The hard parts are already solved.

Members
Enroll and manage members with a single call. Idempotent by email, with metadata and tiers built in.
Rewards
Issue points, cashback, or perks on any event. Redeem anywhere against a consistent, auditable ledger.
Programs
Cashback, points, stamps, tiers, and referrals: compose any loyalty model from a few configurable rules. Run it on web, POS, wallet, or WhatsApp.
Wallet passes
Native Apple and Google Wallet passes that update balances and tiers in real time. Or a WhatsApp profile QR as a passless, appless alternative.
Webhooks
Real-time events for earn, redeem, and tier changes. Signed, replayable, and idempotent by design.
Typed SDKs
First-class SDK for TypeScript today; Python and Go next. Clean REST API and OpenAPI spec for everything else.
Ship with confidence

Try it before it's real.

Test mode mirrors production exactly – webhooks send only what each system asked for.

Test mode
Swap the key, keep the code. Requests validate, respond, and land in logs – no member enrolled, no points moved, nothing sent.
SANDBOX
POST/v1/rewards.issue
authorization:'sk_test_9f…c1'
idempotency-key:'ord_8812'
202simulated·no email, no push
202 · simulated31 ms
Modular webhooks
Subscribe each service to only the events it cares about. Toggle an endpoint and the fan-out changes – no redeploy.
reward.issued2 endpoints
orders-worker4 events
wallet-pass-service2 events
crm-sync1 event
5 attempts · exponential backoff · replay from the log
Agents

Run your program by talking to your AI assistant.

Connect Perkss to Claude, ChatGPT, Codex, Gemini, or Grok and configure your whole program in a conversation - mechanics, members, branding, stores. Coming soon

Works with your favorite agents
ClaudeCodexGeminiGrok
Get started

Ship your loyalty program this afternoon.

Create a program, enroll members, and issue your first rewards with a few API calls.

Book a demo
Physical stores

Works with your POS and payment systems.

Add retention to the systems you already run.

Android terminalsShopify POSNFC readersKiosk checkoutsTap-to-pay
POS · 01
Merchant· Acquirers / banks system
9:41Thu Apr 10
Current sale2 items
Merchant Pulse 2Graphite · 44mm€199.00
Woven Sport BandSand · S/M€29.00
Subtotal€228.00
BBernardoMerchant member since 2024Returning
Gold7 visits1,240 pts
Gold reward applied−€15.00
Subtotal€228.00
Gold reward−€15.00
Total€213.00
Tap card or phone to pay
Charge €213.00
Returning customer recognizedCard tapped · Bernardo, Gold
Portable payment terminal recognizing a Perkss member
Welcome backBernardoGOLD · 1,240 pts
Book a demo
Platforms

Embedded in your storefront, your site, and your app.

One-click install on Shopify, or drop the SDK into your own site and app. Same members, same balance, same passes everywhere.

ShopifyReact NativeswiftSwiftktKotlinWeb SDK
One-click Shopify install
Connect from the Shopify App Store. No theme edits, no custom code, live the same day.
Embedded in your website
Drop-in components for enrolment, balance and redemption on any stack – Next.js, Astro, plain HTML.
Native mobile SDKs
Swift and Kotlin for native apps, or one React Native package covering both platforms.
Integrations

Connects to your whole stack

Perkss plugs into the tools you already run: commerce, ERP, payments, wallets, email, and AI. Loyalty flows everywhere your customers do.

ShopifyKKlaviyoResendStripeApple PayGoogle PayGmailClaudeShopifyKKlaviyoResendStripeApple PayGoogle PayGmailClaude
OdooDYDynamicsSquareMailchimpMBMindbodyMOMomenceGrokCodexOdooDYDynamicsSquareMailchimpMBMindbodyMOMomenceGrokCodex

Start retaining customers today

Create your first program and issue a live reward in minutes.

Read the docs