network.attested.payment.scheduled

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

Details · record, key tid
Kindrecord
Record keytid
Authoritypayment.attested.network
Indexed

Record

record · key tid

Properties

amount

requiredinteger

Amount per payment in the smallest unit of the given currency.

  • minimum: 1

count

requiredinteger

Total number of scheduled payments.

  • minimum: 2
  • maximum: 60

createdAt

requiredstring · datetime

Timestamp of schedule creation; also the first payment date.

currency

requiredstring

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

  • minLength: 3
  • maxLength: 3

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

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

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

Interval between scheduled payments.

  • 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.

  • 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.

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

  • 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.

  • Look up verified payment records between a payer and a recipient. Returns only records whose attestations have been cryptographically verified. Results may include any combination of oneTime, recurring, and scheduled payment records.