Cashback for agents
Get your shopper a tracked cashback link. They open it and buy, the cashback attaches to their account, and they approve every payout.
- Live endpoint
- GET /api/v1/links
- MCP package (coming soon)
- @sundaypenny/mcp
// GET /api/v1/links?store=booking-com
{
"rate": "Up to 7%",
"status": "estimate",
"tracked_url": "https://sundaypenny.com/go/booking-com?c=K7MQ-R4",
"claim_code": "K7MQ-R4",
"claim_url": "https://sundaypenny.com/claim/K7MQ-R4"
}Get started
Quickstart
Three steps, no key or SDK. Works today.
- 1
Ask for a link
No key or SDK yet: call GET /api/v1/links?store=<slug> and read the JSON.
terminalcurl "https://sundaypenny.com/api/v1/links?store=booking-com" - 2
Hand it to your shopper
They open tracked_url in their own browser before they buy at the store.
Find me a hotel in Lisbon for 3 nights. Use my cashback.Here's your Booking.com cashback link (estimated up to 7%). Open it, then book. Your claim code is K7MQ-R4. - 3
Share the claim code
If they were not signed in, they add the claim code at claim_url within 90 days. Cashback then shows as pending in their account.
Live
Tracked links
GET /api/v1/links?store=<slug> returns a tracked link for one store and a fresh claim code. No key needed for now; it is rate limited to 30 calls a minute per IP. Store slugs are in /stores.json.
Request
curl "https://sundaypenny.com/api/v1/links?store=booking-com"Response
{
"store": "booking-com",
"store_name": "Booking.com",
"rate": "Up to 7%",
"status": "estimate",
"tracked_url": "https://sundaypenny.com/go/booking-com?c=K7MQ-R4",
"claim_code": "K7MQ-R4",
"claim_url": "https://sundaypenny.com/claim/K7MQ-R4",
"terms_url": "https://sundaypenny.com/store/booking-com#terms-heading",
"claim_window_days": 90,
"created_at": "2026-11-17T09:41:12.000Z",
"notes": [
"…"
]
}tracked_url
Give this to the shopper to open in their own browser before they buy. It records the visit and sends them on to the store.
claim_code
Short code, four characters, a dash and two more, with no 0, O, 1 or I so it can be read out or typed. It ties the trip to the shopper.
claim_url
Where the shopper adds the trip to their Sunday Penny account, within 90 days. Signed-in shoppers who open tracked_url are attached automatically.
rate
The store's cashback rate as shown on the site. status is always "estimate": rates are not guaranteed offers.
terms_url
The store's cashback terms on its Sunday Penny page.
How the claim works
- 1
Get a tracked link. Call GET /api/v1/links?store=<slug>. Each call mints a new claim code, so ask once per shopping trip.
- 2
The shopper opens it and buys. Hand tracked_url to the shopper. They open it in their own browser right before they buy; it takes them straight to the store. Automated fetchers get a plain page with the same deal and no visit is counted, so the link only works when a person opens it.
- 3
The shopper claims it. Signed in to Sunday Penny when they open the link? The trip is theirs already. Otherwise they open claim_url, sign in or create an account, and add it. They have 90 days.
- 4
Cashback shows as pending. When the store reports the order, the shopper's share of the commission (80%) shows in My money as pending. Pending until the store confirms, typically 30 to 90 days.
No affiliate network is connected yet. Links go to the store's own homepage with a placeholder tracking parameter, so no orders are reported and no cashback is paid in this demo.
Model Context Protocol · coming soon
MCP server
Not live yet. When it ships it will work with Claude, ChatGPT, Cursor and any client that speaks MCP. The planned sundaypenny config:
{
"mcpServers": {
"sundaypenny": {
"command": "npx",
"args": ["-y", "@sundaypenny/mcp"],
"env": {
"SUNDAYPENNY_API_KEY": "drk_test_…"
}
}
}
}Planned tools
search_stores
search_stores({ query, category? })
Find stores by name, category or shopping intent. Each result carries the current rate and an agent_ready flag.
get_rate
get_rate({ merchant })
Current cashback rate for one merchant, including any upsized offer.
create_cashback_link
create_cashback_link({ merchant, intent? })
Returns a tracked link and claim code, like GET /api/v1/links does today. Once agent keys exist, the cashback will attach to the user who linked the agent.
get_wallet
get_wallet()
Read-only balance, pending cashback and the per-agent ledger. There is no withdraw tool.
HTTP · coming soon
More endpoints
A keyed API at https://api.sundaypenny.demo, authenticated with an agent key as a bearer token. Not live yet; use GET /api/v1/links today.
- GET
/v1/storesSearch stores and rates - GET
/v1/rates/{merchant}Current rate for one merchant - GET
/v1/walletBalance and per-agent ledger
Receipt cashback · concept
In-store offers
Agents can read the in-store offers at /offers.json and add offers to the shopper's list on their behalf. The shopper still buys in store and scans the receipt themselves, and the cashback lands in their wallet. The add_instore_offer tool and POST /v1/instore/list are a concept, like the rest of this API. Browse the offers on the in-store page.
add_instore_offer
add_instore_offer({ offer })
Adds one offer, named by its slug in /offers.json, to the shopper's in-store list. It cannot scan receipts or withdraw.
- POST
/v1/instore/listAdd an offer to the shopper's in-store list
Request
curl -X POST https://api.sundaypenny.demo/v1/instore/list \
-H "Authorization: Bearer $SUNDAYPENNY_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "offer": "vegemite-280g" }'Response
{
"offer": "vegemite-280g",
"on_list": true,
"offers_on_list": 1,
"tracked_for": "usr_demo",
"agent": "agt_grocery_bot"
}Events · coming soon
Webhooks
Not live yet. You will subscribe to events to keep your agent in sync with the cashback lifecycle. Each request carries a SundayPenny-Signature header, an HMAC-SHA256 of the raw body.
cashback.tracked
The merchant reported an order made through your link. Cashback is pending.
cashback.confirmed
The order cleared the return window. Cashback is payable, with your approval.
{
"id": "evt_1a2b3c",
"type": "cashback.tracked",
"created": "2026-10-07T09:41:12Z",
"data": {
"claim_code": "K7MQ-R4",
"merchant": "booking-com",
"agent": "agt_travel_bot",
"user": "usr_demo",
"order_value": { "amount_cents": 41200, "currency": "AUD" },
"cashback": { "amount_cents": 2307, "currency": "AUD", "status": "pending" }
}
}{
"id": "evt_4d5e6f",
"type": "cashback.confirmed",
"created": "2026-10-21T02:10:44Z",
"data": {
"claim_code": "K7MQ-R4",
"user": "usr_demo",
"cashback": { "amount_cents": 2307, "currency": "AUD", "status": "confirmed" }
}
}Controls · coming soon
Agent wallet
Not live yet, sample data below. Every agent will get its own spend and cashback ledger, plus a monthly cap you set. Agents can read the wallet. Only you can withdraw from it.
Travel bot
Tracked spend this month
$672.00 / $1,000.00 cap
Grocery agent
Tracked spend this month
$138.50 / $400.00 cap
Shopping agent
Tracked spend this month
$189.00 / $300.00 cap
Ledger
Confirmed $48.40|Pending $28.84
| Date | Agent | Merchant | Order | Cashback | Status |
|---|---|---|---|---|---|
| 07 Oct | Travel bot | Booking.com | $412.00 | +$28.84 | Pending |
| 05 Oct | Grocery agent | Woolworths | $138.50 | +$2.08 | Confirmed |
| 03 Oct | Travel bot | Agoda | $260.00 | +$31.20 | Confirmed |
| 02 Oct | Shopping agent | THE ICONIC | $189.00 | +$15.12 | Confirmed |
Booking.com
Travel bot · 07 Oct · $412.00
+$28.84
PendingWoolworths
Grocery agent · 05 Oct · $138.50
+$2.08
ConfirmedAgoda
Travel bot · 03 Oct · $260.00
+$31.20
ConfirmedTHE ICONIC
Shopping agent · 02 Oct · $189.00
+$15.12
Confirmed
Spending caps. Set a monthly ceiling per agent. Links stop being issued once the cap is reached.
You approve payouts. Agents can read the ledger. Withdrawals need your sign-off in the app.
Questions
FAQ
Who gets the cashback?
Can agents withdraw?
Which stores work with agents?
How does attribution work?
Is it free?
Want your agent earning cashback?
Tracked links work today and the MCP server is next. Join free and we'll show you the agent flow first.
Join free