# OpenPay vocabulary (v1)

Stable IRIs for the OpenPay payment-acceptance open standard.
Maps `Money`, `Currency`, `PaymentMethod`, `Receipt`, `Refund`,
`Dispute`, the five rails (FedNow / PIX / SEPA Instant /
stablecoins), the four card schemes, and the receipt lifecycle
states to globally unambiguous IRIs under
`https://openpay.transaction.science/vocab/v1#` (prefix `op:`).

| File | Format | What |
|------|--------|------|
| [`v1.jsonld`](v1.jsonld) | JSON-LD `@context` | Term → IRI mapping. Adds typed RDF semantics to any OpenPay JSON without changing its wire form. |
| [`v1.ttl`](v1.ttl) | Turtle (RDF) | Classes, enumerations, properties; rail + scheme + lifecycle taxonomies. |
| [`v1.shapes.ttl`](v1.shapes.ttl) | SHACL Core | Shape graph — validates `Money`, `Receipt`, `Refund`, `Card` payment method locally before a rail-driver call. SHACL Core only; consumable by any conformant validator. |

A receipt that carries
`@context: "https://openpay.transaction.science/vocab/v1.jsonld"`
expands into typed RDF triples readable by any JSON-LD parser or
SPARQL store. Existing OpenPay consumers ignore `@context` and keep
working — the wire form is unchanged.

Mirrors the pattern shipped at `jouleclaw/vocab/v1`. Licence
Apache-2.0 to match the OpenPay reference implementation.