From 5237c8ab8535138f7cfca6be78b1eb565e9eae57 Mon Sep 17 00:00:00 2001
From: matst80 <mats.tornberg@gmail.com>
Date: Fri, 3 Jul 2026 19:29:14 +0200
Subject: [PATCH] notes

---
 capture.go | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/capture.go b/capture.go
index 4146f9c..1651b8d 100644
--- a/capture.go
+++ b/capture.go
@@ -1,3 +1,14 @@
+// File capture.go holds CaptureData — the wire payload used when an order
+// claims a payment authorisation or records fulfilment capture.
+//
+// Consumers:
+//   - PersistingOrderHandler in main.go on the OrderPlaced path.
+//   - A small backoffice admin route kicks capture.
+//
+// It is NOT a public HTTP surface; its JSON field names mirror the UCP
+// capture.v1 schema that go-cart-actor publishes on the se_* RabbitMQ
+// exchange. If you change a field here, you almost certainly have to
+// change go-cart-actor's emit site at the same time.
 package main
 
 type CaptureData struct {