notes

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 {