ChronicleSchema

Properties

PropertyExpected typeDescription
Properties of FinancialTransaction
amount one MonetaryAmount How much money moved. On a FinancialTransaction, it is the whole amount, and its value is positive. The action that produced the transaction says who paid and who was paid. On a FinancialPosting, it is the change to the posting's account, and its value is signed. It is negative where the money came from and positive where it went. A positive value increases an asset or an expense account, and a negative one increases a liability, an income, or an equity account, so a purchase paid with a card is negative on the card's account.
recipient many Agent An agent the message, call, or transaction was directed to, such as each other participant in a group conversation or the merchant that was paid.
From Entity
about many Entity What the entity is about, such as a topic or a tag.
alternateName many Text Another name the entity was shown with, such as the display name a message gave its sender or a recipient. An entity can have many.
body one Text The text content of an entity, such as a shell command or a message. It is plain text or Markdown. Not allowed: HTML (<p>Hello</p>).
category many Text A text label that classifies the entity, such as breakfast for a Meal or car for a PhysicalObject.
contains many MediaObject A media file that is part of the entity, such as an attachment to a Message, the photo in a Post, or the images and videos in a carousel. Each one has its most specific type, such as ImageObject.
description one Text Text that describes an entity, such as a task's notes or a project's summary. It is plain text or Markdown. Not allowed: HTML (<p>Buy milk</p>).
emblem one ImageObject The image an entity presents itself by, such as an avatar, a poster, a cover, a logo, or a favicon. It stands for the entity but is not its content, so changing it does not change the entity. It can be a photograph or any other image. Banners and headers are not emblems.
handle one Text An identifier for an entity within a namespace, such as a username, a channel slug, or a tag label. What it identifies depends on that namespace.
inAccount many Agent or FinancialAccount The account that holds the entity. For an account with a service, it is the agent whose account it is, as that service knows them, such as the owner of an email account a message was delivered to. For a FinancialAccount, it is the account itself, such as the one a FinancialPosting is on or a PaymentCard draws on. An entity held in several accounts is inAccount each. Identifiers an account issues are unique within it.
inRealm one Realm The realm the entity is in, such as the computer system that holds a conversation or a file. Identifiers local to the realm are unique within it.
isPartOf many Entity A whole that the entity is part of, such as a task's project, the page an excerpt comes from, or the transaction a posting belongs to. Seen from the whole, its parts are its hasPart values.
location one Location or Place Where the action happened, or where the entity or event is.
name one Text The name or title of an entity, such as a person's display name, a document's title, or a place's name.
references many Entity An entity this one refers to, such as one it @mentions, a page it links to, or a work it cites.
sameAs many Entity or Text Another reference to the same entity, either an entity or a text reference such as @me. It states that both refer to one thing, not that they are similar or related.
tags many Text A text label for the entity. A label that is an entity of its own is a Tag.
url one URL A URL at which the entity can be found, such as a web page's address or a link to the record in its source.
From Base
source one Text The source that describes the entity or action, such as things-todo. Identifiers such as sourceId are unique within it.
sourceId one Text The identifier the source gives an entity or action, such as a record ID or message ID. It is unique only within its source.

Used as a value

A FinancialTransaction can be the value of these properties.

Examples

A card purchase

You bought a coffee with a credit card, and within minutes the card's issuer told Wallet about it.

{
  "@type": "PayAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "apple-wallet",
  "timestamp": "2026-05-09T13:41:07.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "sourceId"],
    "source": "icloud",
    "sourceId": "1234567890",
    "handle": "sam@example.com",
    "sameAs": ["@me"]
  },
  "instrument": [
    {
      "@type": "PaymentCard",
      "@key": ["@type", "source", "sourceId"],
      "source": "apple-wallet",
      "sourceId": "V-0000000000000000000001",
      "name": "Example Rewards Visa",
      "alternateName": ["4242"],
      "category": ["credit"],
      "inAccount": [
        {
          "@type": "FinancialAccount",
          "@key": ["@type", "source", "sourceId"],
          "source": "apple-wallet",
          "sourceId": "8d2f0c4a1b7e9f3c5a6d4e2b1c9f8a7d6e5b4c3a2f1e0d9c8b7a6f5e4d3c2b1a",
          "name": "Example Bank",
          "financialAccountType": "liability"
        }
      ]
    }
  ],
  "result": {
    "@type": "FinancialTransaction",
    "@key": ["@type", "source", "sourceId"],
    "source": "apple-wallet",
    "sourceId": "7C1E9F2B-6A3D-4B58-9E0F-2D4C6B8A1E35",
    "amount": {
      "@type": "MonetaryAmount",
      "value": 4.75,
      "currency": "CAD"
    },
    "recipient": [
      {
        "@type": "Agent",
        "@key": ["source", "name"],
        "source": "apple-wallet",
        "name": "Example Café"
      }
    ],
    "hasPart": [
      {
        "@type": "FinancialPosting",
        "@key": ["@type", "source", "action.result.sourceId", "inAccount[*].sourceId"],
        "source": "apple-wallet",
        "amount": {
          "@type": "MonetaryAmount",
          "value": -4.75,
          "currency": "CAD"
        },
        "inAccount": [
          {
            "@type": "FinancialAccount",
            "@key": ["@type", "source", "sourceId"],
            "source": "apple-wallet",
            "sourceId": "8d2f0c4a1b7e9f3c5a6d4e2b1c9f8a7d6e5b4c3a2f1e0d9c8b7a6f5e4d3c2b1a"
          }
        ]
      }
    ]
  }
}

URI https://schema.chronicle.app/FinancialTransaction · Suggest a change

Esc

↑↓ to move↵ to open/ or ⌘K to search