com.atiproto.payment.item.validate

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Validate that the authenticated user (as the sender) has completed item payment(s). Looks up by itemUri (a specific item record), recordUri (sums all items for that record), or subject (recipient DID). These are mutually exclusive and resolved in that order.",
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "amount": {
              "description": "Sum of all verified completed item amounts in cents",
              "type": "integer"
            },
            "currency": {
              "description": "Currency of the items",
              "maxLength": 3,
              "type": "string"
            },
            "reason": {
              "description": "If invalid, reason for rejection",
              "maxLength": 1024,
              "type": "string"
            },
            "valid": {
              "description": "Whether the authed sender has completed and verified item(s)",
              "type": "boolean"
            }
          },
          "required": [
            "valid"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "amount": {
            "description": "Expected item amount in cents. If omitted, only checks that a item exists.",
            "type": "integer"
          },
          "itemUri": {
            "description": "AT-URI of a specific item record. Takes precedence over recordUri and subject.",
            "format": "at-uri",
            "type": "string"
          },
          "recordUri": {
            "description": "AT-URI of the record being tipped. Takes precedence over subject.",
            "format": "at-uri",
            "type": "string"
          },
          "subject": {
            "description": "DID of the item recipient. Ignored if itemUri or recordUri is provided.",
            "format": "did",
            "type": "string"
          }
        },
        "type": "params"
      },
      "type": "query"
    }
  },
  "id": "com.atiproto.payment.item.validate",
  "lexicon": 1
}