Payments — event contract

binding spec asyncapi/payments.asyncapi.yaml @ 2.0.0 is the spec of record. It states what must be; implementations converge on it, never the reverse.

Enforced by

• any change must bump the artifact and service versions (check:version); a silent edit fails CI
• a breaking change must take a major version (check:compat)
• Spectral lint, house naming rules included
• Microcks contract tests hold mocks and implementations to these messages

Version history

Version	First released	Service version
2.0.0	2026-08-27	3.0.0
1.1.0	2026-08-24	2.1.0
1.0.0	2026-08-23	2.0.0
0.7.0	2026-08-23	1.0.0

Consume it

• Agents, over MCP: get_artifact('payments', 'asyncapi/payments.asyncapi.yaml')
• Raw spec: asyncapi/payments.asyncapi.yaml
• Implementations pin the release tag payments/v3.2.0 in their contracts.lock and fetch read-only; the full loop is on Drive an implementation.

payments.settled.v2

Emitted once funds have irrevocably settled for an order.

Produced by Payments — consumed by Orders.

sequenceDiagram
    autonumber
    participant payments as Payments
    participant chan as payments.settled.v2
    participant orders as Orders
    payments-)chan: PaymentSettled
    Note right of chan: com.hungovercoders.payments.settled.v2
    chan--)orders: PaymentSettled

PaymentSettled

Payment settled

Event type com.hungovercoders.payments.settled.v2

Payload (data)

Field	Type	Required	Constraints
payment_id	string (uuid)	required	—
order_id	string (uuid)	required	—
settled_at	string (date-time)	required	—
amount_pence	integer	required	≥ 0

CloudEvents envelope

Field	Type	Required	Constraints
specversion	string	required	always '1.0'
id	string (uuid)	required	—
source	string	required	always '/payments'
type	string	required	always 'com.hungovercoders.payments.settled.v2'
subject	string (uuid)	required	—
time	string (date-time)	required	—
datacontenttype	string	required	always 'application/json'

Example events (Microcks fixtures)

settled

{
  "specversion": "1.0",
  "id": "cccccccc-3333-4333-8333-cccccccccccc",
  "source": "/payments",
  "type": "com.hungovercoders.payments.settled.v2",
  "subject": "44444444-4444-4444-4444-444444444444",
  "time": "2026-08-23T09:01:30Z",
  "datacontenttype": "application/json",
  "data": {
    "payment_id": "44444444-4444-4444-4444-444444444444",
    "order_id": "11111111-1111-1111-1111-111111111111",
    "settled_at": "2026-08-23T09:01:30Z",
    "amount_pence": 2500
  }
}

Full rendered contract