live: tracked links

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
// 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. 1

    Ask for a link

    No key or SDK yet: call GET /api/v1/links?store=<slug> and read the JSON.

    terminal
    curl "https://sundaypenny.com/api/v1/links?store=booking-com"
  2. 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. 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.

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:

mcp.json
{
  "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

POST /v1/instore/list
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

200 OK
{
  "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.

cashback.tracked
{
  "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" }
  }
}
cashback.confirmed
{
  "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

  • Booking.com

    Travel bot · 07 Oct · $412.00

    +$28.84

    Pending
  • Woolworths

    Grocery agent · 05 Oct · $138.50

    +$2.08

    Confirmed
  • Agoda

    Travel bot · 03 Oct · $260.00

    +$31.20

    Confirmed
  • THE 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?
The shopper whose Sunday Penny account the trip is attached to: automatically if they are signed in when they open the tracked link, or when they add the claim code at the claim page within 90 days. Never the agent or the developer who built it.
Can agents withdraw?
No. The live endpoint only creates links. There is no withdraw tool or endpoint, and payouts will only move after the shopper approves them in the app.
Which stores work with agents?
GET /api/v1/links works for every store. Stores flagged agent-ready also accept purchases an agent starts itself; in this demo that is 18 stores, marked agentReady in /stores.json. Browse them on the stores page.
How does attribution work?
GET /api/v1/links mints a claim code and a tracked_url carrying it. When the shopper opens the link, we record the visit and pass the code to the store's affiliate network as its tracking reference. The network reports the order back with that code, and the cashback shows as pending, then confirmed or declined once the store's return period ends. No network is connected yet, so in this demo no orders are reported.
Is it free?
Yes. Getting a link costs nothing, and cashback is a share (80%) of the commission stores already pay for referred sales.

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
Your list is empty