Article Tip

D-2.8 · listener tip-jar endpoint.

Body: {listener_token?, amount_usd, note?, tx_hash?}. Records a pending tip + the 70/20/10 ledger split:

  • 70% to article's publisher
  • 20% to the recommender (Article.sender_email → ListenerSubscription) — falls into the publisher's share when no recommender is on file
  • 10% to the platform

Status flow: pending → settled when tx_hash is confirmed (operator or x402 facilitator hits PATCH /v1/admin/tips/{id}/settle). Until then the LedgerEntry rows stay 'pending' too, so payouts can't advance against an unconfirmed tip.

post/v1/articles/{slug}/tip

Request

  • Base URL: https://api.storyflo.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.storyflo.com/v1/articles/{slug}/tip
  • Auth: none declared

Path parameters

slugstring required

Headers

idempotency-keystring nullable

Request body

listener_tokenstring nullable
amount_usdnumber required
notestring nullable
tx_hashstring nullable

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.