Changeset 12138

Timestamp:

4 Dec 2014, 04:01:07 (10 years ago)

Author:

uli

Message:

Try to make IPayment more consistent.

File:

• main/waeup.ikoba/branches/uli-payments/src/waeup/ikoba/payments/interfaces.py (modified) (2 diffs)

main/waeup.ikoba/branches/uli-payments/src/waeup/ikoba/payments/interfaces.py

@@ -52 +52 @@
     """A base representation of payments.
 
+    A payment can be approve()d, which means the act of paying was
+    really performed. It can also fail for any reason.
+
     """
     payment_id = schema.TextLine(
@@ -99 +102 @@
         )
 
+    def approve():
+        """Approve a payment.
+
+        The payment was approved and can now be considered payed. This
+        kind of approvement means the final one (in case there are
+        several instances to ask).
+        """
+
+    def mark_failed(reason=None):
+        """Mark the payment as failed.
+
+        A failed payment was canceled due to technical problems,
+        insufficient funds, etc.
+        """
+
 
 class IOnlinePayment(IPayment):