Gocushy

Subscribe the merchant's own system to order events (order.paid, order.refunded, order.failed, order.upsell_taken). Returns the HMAC signing secret exactly once — deliveries carry X-Gocushy-Signature (hex HMAC-SHA256 of the raw body).

Permanently remove a follow-up rule (IDs from list_followups). Buyers already subscribed or tagged stay in the merchant's ESP — this only stops future fan-out. If the merchant just wants a pause, use update_followup with enabled=false instead so the configuration survives.

The account's full activity trail, newest first — every meaningful action taken by the merchant in their dashboard (actor: user), by you or any other agent via the API (actor: ai, tagged with the API key used), and automatically by gocushy (actor: system — orders paid/failed/refunded). Use it to answer "what changed on my account?", to review your own past actions before making changes, or to brief the merchant on recent account history.

The shareable referral link for an affiliate + offer combination. Attribution is server-side on the hosted checkout — the link is all they need.

Which ads actually made money — including the rebills and upsells an ad pixel never reports. Rows carry orders, revenue (net of refunds), rebill revenue to date, total, LTV per customer, refund rate, and ROAS where spend has been reported. Group by source, campaign, or ad. Attribution is honest last-click by default (`touch: 'first'` for first-click); it is NOT modelled multi-touch, and the exact definitions come back in the `definitions` field — quote them rather than inventing your own. Revenue with no captured ad click is reported separately as `unattributed_*` and must never be described a…

Get the hosted checkout URL for an offer (by offer name or slug). Paste it anywhere — it works immediately. ALWAYS pass utm_source (plus utm_campaign and utm_content) when the seller says where the link is going — an email, a video, a post, an affiliate. Meta and Google attach their own click ids, but every other channel arrives untagged and is reported forever as 'direct'. This cannot be fixed after the fact: by the time anyone reads the report, the information was never recorded. Use the same utm_campaign across one push, and vary utm_content per message so they can be compared.

Get copy-paste snippets to put an offer's checkout on any website (Lovable, WordPress, hand-coded — anything). Returns THREE ways so the merchant can choose: a plain link (loads the hosted checkout), a lightbox popup (opens over their page), and an inline embed (checkout rendered inside their page). Default to offering all three.

Deep-dive on a single offer: net revenue (gross minus refunds), paid orders + AOV, checkout completion rate (started-to-paid; page views are not tracked), bump/upsell take rates + upsell revenue, refund rate, daily revenue series, and the 20 most recent orders. Use for how-is-X-doing questions and before recommending changes to an offer.

The receipts for one attribution row: the actual orders (date, buyer, amount net of refunds, status) that get_attribution_report counted under a given source / campaign / ad. Use it when the seller asks 'which orders?' or doubts a number — an aggregate is only as trustworthy as the ability to check it, and this uses the identical filters and attribution as the report, so it always reconciles. Returns up to 50 newest plus the true total. Rebills are not listed (they belong to the origin order's LTV). Requires the Trace subscription.

Get the authoritative, tax-correct total for an offer in a given country, plus a signed short-lived quote token. This is EXACTLY what the checkout will charge — server-computed and tamper-proof. Does NOT charge anything.

One line per traffic source: revenue, rebills, LTV, and ROAS where the merchant has reported ad spend. Use for 'how are my ads doing?'. If `spend_reported` is false, ROAS is null — say so plainly and offer to record spend with report_ad_spend rather than estimating a number. Requires the Trace subscription.

Revenue and conversion stats: totals, order counts, bump/upsell take rates, plus by_offer and by_project rollups. Pass `project` to scope everything to one project — the answer to 'how did iGloo do this week?'.

Bring what the merchant already sells: imports active products (with default prices) from their connected Stripe account into gocushy. Idempotent — re-running updates instead of duplicating. Follow up by composing offers with create_offer.

All affiliates with their referral codes and currently-due balances (released commissions minus clawbacks).

Every campaign short link on the account with its tags, destination and click count — busiest first. Use it before minting a new one (codes must be unique), and to answer 'which of my links are people actually clicking?'. Clicks here are raw link clicks; pair with get_attribution_report for the revenue those clicks produced.

All coupons with their discount, scope, redemption counts, expiry, and active status.

Every follow-up rule across the account's offers, with per-rule health: enabled, last_fired_at (null = never fired), and the connection's status + error if its ESP credentials broke. ALWAYS call this before set_followup — creating a rule that already exists stacks a duplicate that double-tags every buyer. Also your first stop when the merchant asks why follow-up emails aren't going out.

List a seller's live offers (slug, name, price, billing, and each offer's contract URL). Needs the seller's gocushy account id (from a /c/<account>/<slug> link or a cushy.link you were given).

Recent orders: buyer, status (pending/paid/failed/refunded), totals, whether the bump and upsell were taken.

List this account's products with their IDs and prices.

List the merchant's Stripe Tax registrations (country + status).

After the merchant has actually sent an affiliate their released balance (PayPal/Wise/bank — their choice), record it here. Returns the amount marked. Confirm with the merchant before calling — this is bookkeeping, not a money movement.

Check whether Stripe onboarding is complete and the account can take payments (charges_enabled).

Read a gocushy offer as a machine-readable contract: name, price, product, what's included, delivery, payment rails, seller, availability. Provide account+slug, or a checkout URL (gocushy.com/c/… or a cushy.link).

Refund a paid order (full by default, or partial via amount_cents). Reverses the transfer and returns the platform fee. Irreversible — confirm with the merchant before calling.

Tell gocushy what was spent on a network for a period, so Trace can compute ROAS against real revenue. gocushy deliberately does NOT connect to ad accounts — you already have that access, so you fetch the spend and report it here. Idempotent per (source, campaign, period): re-reporting the same period updates it instead of double-counting, so it is safe to re-run. Omit `campaign` for all campaigns on that source. Report the real figure from the ad platform; never estimate one.

Get or set the seller's once-per-business answers — currency, brand accent colour, checkout template, and standard guarantee. Call with NO fields to read them. gocushy applies these AUTOMATICALLY: new products inherit the currency, and checkouts inherit accent/layout/guarantee unless the offer overrides them — so once these are set, don't re-ask the seller for currency, brand colour, template, or guarantee terms. If they're unset at the start of a selling session, offer to capture them once ('What currency do you sell in? Brand colour? Standard guarantee?').

Set the merchant's business profile: legal name, address, tax registration, invoice prefix. Shown on checkouts and receipts ('Sold by X · GST 123'). Set collect_tax true to enable automatic tax at checkout — then activate Stripe Tax with activate_tax and declare registrations with add_tax_registration (no separate Stripe dashboard needed; gocushy merchants use Express accounts, which don't have one).

Send purchases to Meta from gocushy's SERVER instead of relying on the browser pixel, which loses roughly a third of conversions to adblockers and never sees a rebill. Needs the Meta Pixel (dataset) ID and a Conversions API access token from Events Manager — a DATASET-scoped token, never a personal one. Events are deduplicated against the browser pixel by order id, so nothing double-counts. Call with no arguments to read the current setting; the token is write-only and never returned. Pass meta_capi_token: null to switch the rail off. Requires the Trace subscription.

Map an offer to email actions: when the trigger fires (purchase, refund, upsell_taken, renewal, abandoned, payment_failed, or dunning_recovered), the buyer is subscribed to the list and tagged. 'abandoned' fires for checkouts where the buyer STARTED a payment (clicked pay / opened a payment window) but never finished it (30+ minutes, excluded if they later bought) — buyers who only typed their email and left are not captured. 'payment_failed' fires once per dunning episode (a declined one-time payment, a failed renewal, or a PayPal suspension — not on every retry; note PayPal fires the same su…

Check whether Stripe Tax is activated on the merchant's own connected account and which registrations exist. `collecting` is true ONLY when tax is active AND at least one registration is active — otherwise checkout correctly charges no tax. Use this to see what's still needed (e.g. missing head office, or no registration yet).

Change where an existing short code goes, or fix its tags, WITHOUT changing the code. Use this whenever a live link points at the wrong offer or carries a typo'd campaign — never delete and recreate: the code is already out in an email or a post, so it would 404 in between and lose the click history that shows how the campaign performed. Tags MERGE, so passing only utm_campaign leaves the rest alone; pass an empty string to clear one field. Refuses to leave the link without a usable source, since that would report every click as 'direct'.

Set the selling content on an offer's checkout page — described, not designed: your words render into gocushy's fixed, conversion-tested layout, so you can fully customise without ever breaking it. Good direct-response structure: headline = the outcome, bullets = benefits, testimonial = real and specific, guarantee = concrete terms. The checkout object REPLACES the existing blocks — always pass every field you want to keep; pass checkout: null to reset entirely. This also sets a per-offer `checkout_logo_url` (a logo at the very top of this checkout, overriding the account logo) and edits the O…

Edit an existing rule (IDs from list_followups) instead of stacking a new one: retarget its trigger, point it at a different connection or list, swap its tags, or pause/resume it with enabled. Only the fields you pass change — everything else keeps its current value. Pausing (enabled=false) is the right way to stop a promo's follow-up without losing the configuration.

Update a product's name, description, delivery link/note, or (one-time products only) price. USE THIS to set delivery_url when a product was created without one — that's how buyers receive what they bought (shown on the thank-you page and receipt). Subscription prices can't be edited (renewals bill the original price) — create a new product instead.

Check whether an email address has bought from this merchant (optionally a specific product or offer). Use to gate access to content, communities, or support.