network.attested.payment.oneTime

attested.network

Documentation

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

main record

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

Record Key tid Timestamp-based ID

Properties

amount integer Required

Payment amount in the smallest unit of the given currency (e.g. cents for USD).

minimum: 1
createdAt string datetime Required

Timestamp of record creation.

currency string Required

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

maxLength: 3 bytesminLength: 3 bytes
entitlements array of ref com.atproto.repo.strongRef Optional

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.

memo string Optional

Optional note from the supporter.

maxLength: 1024 bytesmaxGraphemes: 256 graphemes
signatures array of ref com.atproto.repo.strongRef Optional

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

subject string did Required

DID of the creator receiving payment.

txnid string Required

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

maxLength: 64 bytes
View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "subject",
      "amount",
      "currency",
      "txnid",
      "createdAt"
    ],
    "properties": {
      "memo": {
        "type": "string",
        "maxLength": 1024,
        "description": "Optional note from the supporter.",
        "maxGraphemes": 256
      },
      "txnid": {
        "type": "string",
        "maxLength": 64,
        "description": "Unique transaction identifier for deduplication. Typically a ULID or UUID assigned by the payment broker."
      },
      "amount": {
        "type": "integer",
        "minimum": 1,
        "description": "Payment amount in the smallest unit of the given currency (e.g. cents for USD)."
      },
      "subject": {
        "type": "string",
        "format": "did",
        "description": "DID of the creator receiving payment."
      },
      "currency": {
        "type": "string",
        "maxLength": 3,
        "minLength": 3,
        "description": "ISO 4217 currency code (e.g. USD, EUR)."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Timestamp of record creation."
      },
      "signatures": {
        "type": "array",
        "items": {
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "description": "Attestation entries. Each entry is a com.atproto.repo.strongRef pointing to a network.attested.payment.proof record in a creator or broker repository."
      },
      "entitlements": {
        "type": "array",
        "items": {
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "description": "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."
      }
    }
  },
  "description": "A one-time payment from a supporter to a creator. Represents a single, non-recurring financial transaction attested by one or more parties."
}

Lexicon Garden

@