All platforms

Agents for Lemon Squeezy

Lemon Squeezy serves as the merchant of record for digital commerce and subscriptions, handling tax compliance, billing, and dispute resolution. In Pump Up playbooks, an AI agent coordinates billing workflows across customer support, finance, and operations. The agent pulls order receipts, subscription states, and payment invoices to evaluate refund eligibility, prepare merchant chargeback evidence packets, investigate reconciliation variances against bank payouts, and audit member access. Human operators retain final authority over discretionary refunds, disputed evidence submissions, and financial write-offs.

4 related templates

When to use it

Finance leads, customer support managers, and operations teams managing digital software and subscription billing through Lemon Squeezy.

Example scenario

A software subscriber requests a refund three weeks into an annual plan citing an accidental duplicate seat purchase. The agent fetches the order record and active subscription history from Lemon Squeezy, noting zero license key activations while distinguishing that lack of activation does not prove the software was never downloaded. It flags the unverified download status for the support lead, checks company policy, and calculates the prorated balance minus non-recoverable platform fees. The support manager evaluates the customer statement and approves a partial credit. The agent then calls the Lemon Squeezy refund endpoint or directs manual dashboard execution, reads back the updated order status to confirm the refund succeeded, and only then notifies the subscriber.

Getting started

  • Generate a Lemon Squeezy personal API access token with read access to orders, subscriptions, and customers
  • Configure webhook endpoints for order_created, order_refunded, and subscription lifecycle events
  • Define team refund review thresholds, acceptable dispute response windows, and support escalation channels
  • Map Lemon Squeezy store IDs and product variants to internal accounting ledger codes

Common questions

Does Lemon Squeezy act as a direct payment gateway or a merchant of record?

Lemon Squeezy operates as a merchant of record, meaning it legally processes customer transactions, calculates and remits global sales tax and VAT, and manages payment dispute procedures with card networks on behalf of the seller.

Can an AI agent issue refunds directly through the Lemon Squeezy API?

Lemon Squeezy provides official endpoints to issue partial or full refunds for orders and subscription invoices using an optional amount parameter. In Pump Up playbooks, the agent prepares the policy comparison, pauses for human approval, executes the refund via API or approved dashboard entry, and verifies the refunded status before completing the case.

How are chargebacks handled in Lemon Squeezy compared to direct processors?

Because Lemon Squeezy is the merchant of record, it represents disputes directly to payment providers. When a dispute occurs, a $15 fee is charged, and operators supply delivery evidence or customer logs to store operations rather than filing raw network arbitration.

What webhook events notify agents of subscription status changes?

Lemon Squeezy emits webhooks for subscription_created, subscription_updated, subscription_cancelled, subscription_resumed, subscription_expired, subscription_paused, and subscription_payment_failed.

How these workflows use your software

Contract to account setup

Source records
Signed contract terms, customer billing entity, and product tier specifications
Agent work
Agent verifies whether customer billing records and subscription tiers match signed terms
Result
Configured customer subscription record and initial invoice confirmation
Human decision
Operations lead verifies custom pricing overrides and approves initial provisioning

Refund review

Source records
Customer refund ticket, Lemon Squeezy order record, and license activation history
Agent work
Agent evaluates purchase date against policy window, checks license activations, and preserves unverified download uncertainty for owner review
Result
Structured refund recommendation with calculated deduction, activation audit, and order receipt link
Human decision
Support lead evaluates customer explanation, weighs usage uncertainty, and decides whether to approve partial, full, or declined refund

Chargeback evidence preparation

Source records
Dispute notification, transaction metadata, order timeline, and delivery logs
Agent work
Agent collates customer receipt, IP access timestamps, and communications into evidence packet
Result
Consolidated dispute defense dossier formatted for merchant operations review
Human decision
Store operator approves evidence submission or accepts chargeback deduction

Workflow example

Source records
Lemon Squeezy payout reports, platform fee deductions, and accounting ledger entries
Agent work
Agent isolates discrepancies between gross orders, tax withholdings, fees, and bank deposits
Result
Reconciliation exception report with suggested balancing journal adjustments
Human decision
Finance lead approves variance reclassification or requests payout audit

Paid member request resolution

Source records
Member support inquiry, subscription lifecycle state, and billing invoice history
Agent work
Agent verifies active plan standing, payment retry status, and feature entitlements
Result
Entitlement status brief with recommended account modification or billing link
Human decision
Customer success owner authorizes billing grace period or plan tier adjustment

Platform documentation