Lexicon Garden

network.attested.payment.recurring

A recurring payment commitment. Immutable once created — supporters cancel and create new subscriptions to change terms. Bills on anniversary dates with automatic retry on failure.

Repository @attested.network did:plc:cq3w3bw7awp2rkeswfdzoubb namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authoritypayment.attested.network
Indexed
Compare Edit in builder → Fork →

Record

record · key tid

Properties

amount

requiredinteger

Amount per billing period in the smallest unit of the given currency. Applications typically enforce a monthly-equivalent range of 500–25000.

  • minimum: 1

createdAt

requiredstring · datetime

Timestamp of initial subscription creation.

currency

requiredstring

ISO 4217 currency code (e.g. USD, EUR).

  • minLength: 3
  • maxLength: 3

entitlements

array

Optional list of strong references to records representing goods or services the payer is entitled to as a result of this payment. Referenced records may use any lexicon; their schemas are not defined by this spec.

itemsref
Reference

frequency

integer

Billing frequency multiplier applied to the unit (e.g. unit=monthly, frequency=3 bills every three months).

  • minimum: 1
  • default: 1

signatures

array

Attestation entries. Each entry is a com.atproto.repo.strongRef pointing to a network.attested.payment.proof record in a creator or broker repository.

itemsref
Reference

subject

requiredstring · did

DID of the creator receiving payment.

txnid

requiredstring

Unique transaction identifier for deduplication. Typically a ULID or UUID assigned by the payment broker.

  • maxLength: 64

unit

requiredstring

Billing period.

  • knownValues: monthly | quarterly | semiannual | yearly

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • network.attested.payment.scheduled

    record

    A fixed series of payments. Unlike recurring payments that continue indefinitely, scheduled payments specify a total count and terminate automatically upon completion.

  • blue.hearth.tier

    record

    A subscription tier offered by a creator. Lives in the creator's repository, so the creator is the repo owner and is not repeated as a field. Tiers are tied to the creator's DID rather than to any publication or app.

  • network.attested.payment.oneTime

    record

    A one-time payment from a supporter to a creator. Represents a single, non-recurring financial transaction attested by one or more parties.

  • com.atiproto.subscription

    record

    A record representing a subscription from one user to another

  • blue.hearth.entitlement

    record

    Proof that a subscriber currently holds a tier. This is the record attested.network deliberately leaves undefined: its payment records prove a payment happened but carry no expiry, revocation or status, so they cannot answer 'is this subscription active right now'. Lives in the SUBSCRIBER's repository, alongside the payment record that granted it. Entitlements are short-lived and RENEWED, never long-lived and revoked: each successful billing cycle writes a fresh record, so cancellation is the ob