Skip to content

Technology

How PaidRight works under the hood.

AI interprets the evidence. Code handles the money. PayPal holds the payment truth. The creator approves every action.

Model: Claude (claude-sonnet-5-5) via the Anthropic API. Payments: PayPal Invoicing REST API, Sandbox.

Try live demoView source on GitHub (opens in a new tab)

PayPal operations

Every call runs on the server. The OAuth token is fetched server-side and never reaches the browser.

PayPal Invoicing API calls made by PaidRight
OperationAPI call
Create invoicePOST /v2/invoicing/invoices

Stores the real Sandbox invoice ID.

Send invoicePOST /v2/invoicing/invoices/{id}/send

Records the hosted invoice link.

Read invoiceGET /v2/invoicing/invoices/{id}

Authoritative status, fetched on the server.

Send reminderPOST /v2/invoicing/invoices/{id}/remind

Only after the creator approves and a server-side re-fetch confirms it is still unpaid.

Who decides what

  • AI (Claude)

    • Reads the agreement into structured terms, each with a source quote.
    • Explains findings and drafts follow-up messages.

  • Code

    • Does all money arithmetic in integer cents.
    • Sorts amounts into paid, overdue and not-yet-billable buckets.

  • PayPal

    • Is the authoritative source of invoice status.

  • Creator

    • Approves every send. Nothing goes to the brand without a click.

Trust distinctions

  • Verified Sandbox payment is not a production payment, or INR in the creator's bank.
  • A processor fee is not a brand underpayment.
  • An AI recommendation is not authorization to charge anyone.

Why instalments

PayPal India merchants can't accept partial payments on an invoice. So the agreed $150 Stories instalments are two separate invoices. One is paid; one is overdue.

Real vs simulated

Real

  • PayPal Sandbox invoices, statuses and reminders are real API calls.

Simulated

  • GlowLab and Aanya are fictional.
  • The demo may open on a labelled simulated date before the real due date.
  • No real money is involved.

Limitations

  • No webhooks yet. Invoice status is read from PayPal on demand.
  • No brand review link yet.
  • No automated tests yet.
  • Demo state is per browser, while the PayPal Sandbox invoices are shared.