Lexicon Garden

org.hypercerts.funding.receipt

Records a payment from a sender to a recipient. Any party may record it, and the sender may stay anonymous. When the sender chose the recipient, record one receipt to the final recipient even if platforms or hosts passed the funds on. When an intermediary chose (regranting), record the payment into it and each onward payment as separate receipts. A receipt may be updated in place under the same record key: its URI does not change, so references by URI keep resolving, but a strongRef (as likes and reposts use) still pins the earlier CID, and signatures bind to content and must be renewed. An earlier version cannot be recalled from readers that kept it.

Repository @hypercerts.org did:plc:s4puetfspot742ai7y4otuel namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityfunding.hypercerts.org
Indexed
Compare Edit in builder → Fork →

Record

record · key tid

Properties

amount

string

Gross amount the sender paid, before fees, as a numeric string (e.g. '1000.50'). Omit if unknown, and set netAmount instead.

  • maxLength: 50

createdAt

requiredstring · datetime

Client-declared timestamp when this receipt record was created.

currency

string

Currency of amount: an ISO 4217 code for fiat (e.g. EUR), a token ticker for digital assets (e.g. USDC). This is what marks the funds as fiat or digital. Set it whenever amount is set.

  • maxLength: 10

for

ref

Optional strong reference to the activity, project, or organization this funding relates to.

Reference

from

union

The sender of the funds (a free-text string, an account DID, or a strong reference to a record). Optional — omit to represent anonymity. Name a sender only if they chose to be named: from can be added later by updating the receipt in place, but removing it later only hides the name from the current version, and an onchain transactionId still names the sending wallet.

One of

netAmount

string

What the recipient received after fees and conversion, as a numeric string in netCurrency.

  • maxLength: 50

netCurrency

string

Currency of netAmount: an ISO 4217 code for fiat, a token ticker for digital assets. Set it whenever netAmount is set.

  • maxLength: 10

notes

string

Optional notes or additional context for this funding receipt.

  • maxLength: 500

occurredAt

string · datetime

Timestamp when the payment occurred.

paymentNetwork

string

Where transactionId can be looked up: the chain for onchain payments, preferably as a CAIP-2 ID (e.g. 'eip155:1'), otherwise the processor or scheme (e.g. stripe, sepa). Set it whenever transactionId is a transaction hash.

  • maxLength: 50

paymentRail

string

How the sender paid. Use 'payment_processor' only when the underlying method is unknown.

  • maxLength: 50
  • knownValues: onchain | bank_transfer | card | direct_debit | mobile_money | payment_processor | cash | check

signatures

ref

Optional cryptographic signatures attesting to this record's content.

Reference

to

requiredunion

The recipient of the funds (a free-text string, an account DID, or a strong reference to a record).

One of

transactionId

string

ID of the sender's payment, not of a platform's later payout: a transaction hash for onchain payments, otherwise the processor's or scheme's reference. Receipts are public: prefer opaque processor IDs to bank references, and note that a hash reveals the sender's wallet even when from is omitted.

  • maxLength: 256

type

string

What the payment is: a donation (a gift from the sender), a match (funds a matching pool allocated on the strength of other gifts) or a grant (funds awarded through a selection process). Values beyond the known set are permitted. Omit if unknown.

  • maxLength: 50
  • knownValues: donation | match | grant

via

union

Optional intermediary that facilitated or processed the payment (funding platform, payment servicer, broker).

One of

#text

object

A free-text string value (e.g. a display name, wallet address, or other identifier).

Properties

value

requiredstring

The string value.

  • maxLength: 2048

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • network.attested.payment.oneTime

    record

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

  • app.gainforest.organization.donation

    record

    A record of a donation or financial transaction for financial transparency

  • net.wireservice.payment

    record not from the namespace authority

    A single payment or donation, stored in the publication's business space.

  • am.noz.at.spl.settlement

    record

    An immutable record of money paid between two ledger members, optionally filed in a group.

  • fund.at.funding.channel

    record

    A single payment channel where contributions can be made. Each channel is an individual record keyed by its slug ID. Maps to a funding.json channel entry.