{"schema":"https://ver.cy/schemas/card/1.0.0","id":"vr.tr.payment","code":"thing-payment","url":"https://ver.cy/models/thing/payment/","name":"payment","alternateNames":["royalty","bounty","premium","bonus","incentive","dividend","sales incentive","allowance","adjustment","cost-of-living allowance","depreciation allowance","deduction"],"kind":"thing","status":"published","version":"0.2.0-wave.1","language":"en","classifiers":{"family":"Thing Registry","category":"Society, people and institutions","entryKind":"noun.possession","plane":"SOC","domain":["SOC.ECO"],"industry":[],"navPath":"","tags":[],"facets":{"substance":"social","origin":"conceptual","agency":"inert","mobility":"not-applicable","scale":"not-applicable","affordances":["observable"]}},"whatItIs":"A transfer of money or other value from a payer to a payee to discharge an obligation, and the sum so transferred.","purpose":"Let an agent describe payments by parties, amount, method, status and reference, and never execute a payment or transfer on anyone behalf.","scope":{"in":[],"out":[],"boundaries":[]},"distinguishingFeatures":["Discharges an obligation, which distinguishes it from a gift or a loan","Has a method with its own rules for timing, cost and reversal","Authorised by the payer","The same word covers the act and the amount"],"structure":{"bundles":[{"id":"parties-and-amount","name":"Parties and amount","description":"Who pays whom, how much.","layers":[{"id":"parties","name":"Parties","description":"Payer and payee.","findings":[{"id":"parties-finding","name":"Parties identified","description":"Payer and payee and their accounts.","questions":[{"text":"Who is the payer and who the payee?","kind":"definition"},{"text":"Has the payee been verified, for example by name check?","kind":"boundary"}]}]},{"id":"amount","name":"Amount and purpose","description":"Sum, currency and reason.","findings":[{"id":"amount-finding","name":"Amount and purpose","description":"The amount, currency and obligation.","questions":[{"text":"What amount and currency, for which obligation?","kind":"measurement"},{"text":"Which reference links it to the invoice or debt?","kind":"provenance"}]}]}]},{"id":"method","name":"Method","description":"How the payment moves.","layers":[{"id":"channel","name":"Channel","description":"Card, transfer, debit, cash.","findings":[{"id":"channel-finding","name":"Method used","description":"The method and scheme.","questions":[{"text":"By which method and scheme is the payment made?","kind":"definition"},{"text":"What does it cost, and who pays the fees?","kind":"measurement"}]}]},{"id":"timing","name":"Timing","description":"Execution and settlement.","findings":[{"id":"timing-finding","name":"Timing","description":"When it executes and settles.","questions":[{"text":"When will it arrive, and when is it final?","kind":"measurement"},{"text":"What cut-off times apply?","kind":"boundary"}]}]}]},{"id":"status-and-disputes","name":"Status and disputes","description":"Where it is and what if it goes wrong.","layers":[{"id":"status","name":"Status","description":"Pending, completed, failed.","findings":[{"id":"status-finding","name":"Current status","description":"The status and its source.","questions":[{"text":"What is the current status of this payment, according to which system?","kind":"provenance"},{"text":"What does that status mean for the payee?","kind":"definition"}]}]},{"id":"disputes","name":"Disputes and reversal","description":"Chargebacks and recalls.","findings":[{"id":"disputes-finding","name":"Dispute rights","description":"Rights to dispute or reverse.","questions":[{"text":"Can this payment be disputed or recalled, and within what time?","kind":"boundary"},{"text":"Who should the payer contact?","kind":"action"}]}]}]},{"id":"controls","name":"Controls","description":"Authorisation, fraud and law.","layers":[{"id":"authorisation","name":"Authorisation","description":"Strong authentication.","findings":[{"id":"authorisation-finding","name":"Authorisation check","description":"How the payer authorised it.","questions":[{"text":"How was this payment authorised?","kind":"provenance"},{"text":"Must the payer confirm it personally?","kind":"action"}]}]},{"id":"fraud","name":"Fraud and sanctions","description":"Screening and red flags.","findings":[{"id":"fraud-finding","name":"Screening","description":"Fraud and sanctions checks.","questions":[{"text":"Does this payment show fraud red flags?","kind":"boundary"},{"text":"Which sanctions or reporting rules apply?","kind":"boundary"}]}]}]}]},"agentConduct":{"may":["Prepare a payment for a person to review, with payee, amount, currency and reference.","Check a payment against an invoice and flag mismatches, duplicates or unusual payees.","Report the status of a payment the user has authorized it to track."],"mustNot":["Send, approve or release a payment without the payer's explicit authorization for that payment.","Change a payee's account details on the strength of an unverified message.","Split or structure payments to avoid controls or reporting rules.","Hide fees, exchange rates or charges from the payer."],"requiresHuman":["Authorizing any payment or refund.","Adding or changing a payee."]},"ethics":{"considerations":["A wrong or fraudulent payment is often unrecoverable, so the payer's informed consent is essential.","Late or failed payments can push people into penalties and debt."],"affectedParties":["Payers","Payees","Victims of payment fraud"]},"owners":{"steward":"The payer who authorizes it and the payment service provider that executes it.","roles":[],"masterSystems":["Bank and payment service provider transaction records"]},"relations":[{"target":"oewn-13296870-n","type":"parent","note":"registry parent class"},{"target":"money","type":"related","note":"payments transfer money"},{"target":"invoice or debt","type":"related","note":"the obligation discharged"},{"target":"payment system","type":"related","note":"card schemes, SEPA, Faster Payments and others"},{"target":"transfer of funds between own accounts","type":"related","note":"no obligation is discharged"}],"interaction":{"identity":{"applicability":"required","items":["Vercy registry: vr.tr.payment","Open English WordNet: oewn-13299398-n","payment reference: end-to-end id links the payment to its purpose","IBAN: up to 34 characters identifies accounts, not payments","ISO 20022 message: pacs, pain, camt messages standard payment messages"]},"properties":{"applicability":"not-applicable","items":[]},"recognition":{"applicability":"optional","items":["Amount, currency, date, payer, payee and reference","Status: pending, completed, failed, reversed","Types such as royalty, bonus, dividend or premium describe the reason, not the method","A receipt, bank statement line, invoice marked paid, or a confirmation in an app, carrying amount, date, parties and reference."]},"capabilities":{"applicability":"required","items":["initiate and authorise it, which only the payer may do","track it, through its status and reference","reverse or dispute it, under the rules of the method","reconcile it, against invoices and accounts"]},"hazards":{"applicability":"required","items":["Authorised push payment fraud","Wrong payee or amount","Duplicate payments","Failed payments causing penalties"]},"interfaces":{"applicability":"required","items":["EU Payment Services Directive (PSD2) and national equivalents","ISO 20022 financial messaging","Card scheme rules and chargeback procedures","Anti-money-laundering and sanctions law"]},"context":{"applicability":"required","items":["Settling debts and paying for goods, services, wages, taxes and benefits.","by method: cash, card, bank transfer, direct debit, cheque, e-money, instant payment","by purpose: wages, royalties, dividends, bonuses, premiums, taxes","by timing: one-off, recurring, instalment"]}},"sources":[{"title":"Open English WordNet 2024, synset oewn-13299398-n","url":"https://en-word.net/id/oewn-13299398-n","note":"sense and gloss of the concept"},{"title":"Wiktionary: payment","url":"https://en.wiktionary.org/wiki/payment","note":"word senses and usage"}],"openQuestions":["Should payment methods be separate entries?","How should payment status be represented for agents answering \"has it been paid\"?","How should payment purposes merged here, such as dividends and royalties, be split off?"],"resources":{"spec":"/models/things/publications/thing-payment/spec.json"},"provenance":{"origin":"thing registry research (pass 2)","builtFrom":["models/things/publications/thing-payment/spec.json"],"providers":["Claude"],"researchStatus":"unreviewed","generatedAt":"2026-09-11T04:36:02Z","builder":"tools/build_cards.py@1.0.0"},"completeness":{"sections":{"classifiers":"filled","whatItIs":"filled","purpose":"filled","distinguishingFeatures":"filled","structure":"filled","agentConduct":"filled","ethics":"filled","owners":"filled","relations":"filled","interaction.identity":"filled","interaction.properties":"not-applicable","interaction.recognition":"filled","interaction.capabilities":"filled","interaction.hazards":"filled","interaction.interfaces":"filled","interaction.context":"filled","sources":"filled"},"notes":{"_gate":"Published through the thing publication gate 1.0 on 2026-10-07T12:16:28+00:00: completeness 1.00; sense: WordNet gloss; 2 live sources; review by codex: pass","interaction.properties":"Plane SOC: no invented physical properties."},"score":1.0}}