(20241228) Payments module revamped!

models/api/finstitutions/payments/request.py

@@ -230,7 +230,31 @@ class PGPaymentRequestData(BaseModel):
 class PaymentRequestOneResult(BaseModel):
 
     success: bool = Field(
-        description = "whether, or not, the sms was successfully sent",
+        description = "whether, or not, the payment was successfully requested",
+        default = False
+    )
+
+    message: str | None = Field(
+        description = "a brief message to summarize the result of the process",
+        default = None
+    )
+
+    # ┏┓    ┏•
+    # ┃ ┏┓┏┓╋┓┏┓
+    # ┗┛┗┛┛┗┛┗┗┫
+    #          ┛
+
+    class Config:
+        extra = "forbid"
+
+
+# ---------------------------------------------------------------------------------------------------------------------
+
+
+class PaymentCallbackResult(BaseModel):
+
+    success: bool = Field(
+        description = "whether, or not, the payment event was noted",
         default = False
     )