(20250102) Print statement removed.

models/core/payment.py

@@ -134,6 +134,51 @@ class CustomerDetails(BaseModel):
 # ---------------------------------------------------------------------------------------------------------------------
 
 
+class PaymentMetadata(BaseModel):
+
+    """
+    These are things that the UI will send you, and you must use them as-is for adding receipts. Their internal workings
+    and use-cases are not known and are not of this code's direct concern except that you must ensure that these details
+    get delivered through the mechanism of adding receipts.
+    """
+
+    idClient: int = Field(frozen = True)
+    inAccount: int = Field(frozen = True)
+    reference: str | None = Field(frozen = True, default = None, validate_default = True)
+    againstReference: str | None = Field(frozen = True, default = None, validate_default = True)
+    documentUrl: str | None = Field(frozen = False, default = None, validate_default = True)
+
+    # ┏┓    ┏•
+    # ┃ ┏┓┏┓╋┓┏┓
+    # ┗┛┗┛┛┗┛┗┗┫
+    #          ┛
+
+    class Config:
+        extra = "allow"
+
+    # ┓┏  ┓• ┓   •
+    # ┃┃┏┓┃┓┏┫┏┓╋┓┏┓┏┓
+    # ┗┛┗┻┗┗┗┻┗┻┗┗┗┛┛┗
+
+    @field_validator("reference")
+    def validate_reference(cls, value):
+        if not value: value = "On Account"
+        return value
+
+    @field_validator("againstReference")
+    def validate_against_reference(cls, value):
+        if not value: value = None
+        return value
+
+    @field_validator("documentUrl")
+    def validate_document_url(cls, value):
+        if not value: value = None
+        return value
+
+
+# ---------------------------------------------------------------------------------------------------------------------
+
+
 class PaymentEvent(BaseModel):
 
     eventTs: AwareDatetime = Field(