com.atiproto.payment.item.validate

atiproto.com

Documentation

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.

main query

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.

Parameters

amount integer Optional

Expected item amount in cents. If omitted, only checks that a item exists.

itemUri string at-uri Optional

AT-URI of a specific item record. Takes precedence over recordUri and subject.

recordUri string at-uri Optional

AT-URI of the record being tipped. Takes precedence over subject.

subject string did Optional

DID of the item recipient. Ignored if itemUri or recordUri is provided.

Output

Encodingapplication/json
amount integer Optional

Sum of all verified completed item amounts in cents

currency string Optional

Currency of the items

reason string Optional

If invalid, reason for rejection

valid boolean Required

Whether the authed sender has completed and verified item(s)

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Expected item amount in cents. If omitted, only checks that a item exists.
AT-URI of a specific item record. Takes precedence over recordUri and subject.
AT-URI of the record being tipped. Takes precedence over subject.
DID of the item recipient. Ignored if itemUri or recordUri is provided.
View raw schema 
{
  "type": "query",
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "valid"
      ],
      "properties": {
        "valid": {
          "type": "boolean",
          "description": "Whether the authed sender has completed and verified item(s)"
        },
        "amount": {
          "type": "integer",
          "description": "Sum of all verified completed item amounts in cents"
        },
        "reason": {
          "type": "string",
          "maxLength": 1024,
          "description": "If invalid, reason for rejection"
        },
        "currency": {
          "type": "string",
          "maxLength": 3,
          "description": "Currency of the items"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "amount": {
        "type": "integer",
        "description": "Expected item amount in cents. If omitted, only checks that a item exists."
      },
      "itemUri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of a specific item record. Takes precedence over recordUri and subject."
      },
      "subject": {
        "type": "string",
        "format": "did",
        "description": "DID of the item recipient. Ignored if itemUri or recordUri is provided."
      },
      "recordUri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of the record being tipped. Takes precedence over subject."
      }
    }
  },
  "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."
}

Lexicon Garden

@