Records a funding receipt for a payment from one user to another user. It may be recorded by the recipient, by the sender, or by a third party. The sender may remain anonymous.
tid
Timestamp-based ID
Properties
amount
string
Required
Amount of funding received as a numeric string (e.g. '1000.50').
maxLength: 50 bytescreatedAt
string
datetime
Required
Client-declared timestamp when this receipt record was created.
currency
string
Required
Currency of the payment (e.g. EUR, USD, ETH).
maxLength: 10 bytesfor
ref
com.atproto.repo.strongRef
Optional
Optional strong reference to the activity, project, or organization this funding relates to.
from
union
Optional
The sender of the funds (a free-text string, an account DID, or a strong reference to a record). Optional — omit to represent anonymity.
notes
string
Optional
Optional notes or additional context for this funding receipt.
maxLength: 500 bytesoccurredAt
string
datetime
Optional
Timestamp when the payment occurred.
paymentNetwork
string
Optional
Optional network within the payment rail (e.g. arbitrum, ethereum, sepa, visa, paypal).
maxLength: 50 bytespaymentRail
string
Optional
How the funds were transferred (e.g. bank_transfer, credit_card, onchain, cash, check, payment_processor).
maxLength: 50 bytesto
union
Required
The recipient of the funds (a free-text string, an account DID, or a strong reference to a record).
transactionId
string
Optional
Identifier of the underlying payment transaction (e.g. bank reference, onchain transaction hash, or processor-specific ID). Use paymentNetwork to specify the network where applicable.
maxLength: 256 bytesView raw schema
{
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"to",
"amount",
"currency",
"createdAt"
],
"properties": {
"to": {
"refs": [
"#text",
"app.certified.defs#did",
"com.atproto.repo.strongRef"
],
"type": "union",
"description": "The recipient of the funds (a free-text string, an account DID, or a strong reference to a record)."
},
"for": {
"ref": "com.atproto.repo.strongRef",
"type": "ref",
"description": "Optional strong reference to the activity, project, or organization this funding relates to."
},
"from": {
"refs": [
"#text",
"app.certified.defs#did",
"com.atproto.repo.strongRef"
],
"type": "union",
"description": "The sender of the funds (a free-text string, an account DID, or a strong reference to a record). Optional — omit to represent anonymity."
},
"notes": {
"type": "string",
"maxLength": 500,
"description": "Optional notes or additional context for this funding receipt."
},
"amount": {
"type": "string",
"maxLength": 50,
"description": "Amount of funding received as a numeric string (e.g. '1000.50')."
},
"currency": {
"type": "string",
"maxLength": 10,
"description": "Currency of the payment (e.g. EUR, USD, ETH)."
},
"createdAt": {
"type": "string",
"format": "datetime",
"description": "Client-declared timestamp when this receipt record was created."
},
"occurredAt": {
"type": "string",
"format": "datetime",
"description": "Timestamp when the payment occurred."
},
"paymentRail": {
"type": "string",
"maxLength": 50,
"description": "How the funds were transferred (e.g. bank_transfer, credit_card, onchain, cash, check, payment_processor)."
},
"transactionId": {
"type": "string",
"maxLength": 256,
"description": "Identifier of the underlying payment transaction (e.g. bank reference, onchain transaction hash, or processor-specific ID). Use paymentNetwork to specify the network where applicable."
},
"paymentNetwork": {
"type": "string",
"maxLength": 50,
"description": "Optional network within the payment rail (e.g. arbitrum, ethereum, sepa, visa, paypal)."
}
}
},
"description": "Records a funding receipt for a payment from one user to another user. It may be recorded by the recipient, by the sender, or by a third party. The sender may remain anonymous."
}