spec peer push credit transaction

1 files changed, 30 insertions, 2 deletions

diff --git a/design-documents/037-wallet-transactions-lifecycle.rst b/design-documents/037-wallet-transactions-lifecycle.rst
index 94de1667..b882c139 100644
--- a/design-documents/037-wallet-transactions-lifecycle.rst
+++ b/design-documents/037-wallet-transactions-lifecycle.rst
@@ -138,7 +138,7 @@ States and transitions:
 
 * ``pending(purse-created)``
 
-  In this state, the user can send / show the `taler://` URI or QR code to somebody else.\
+  In this state, the user can send / show the ``taler://`` URI or QR code to somebody else.
 
   * ``[action:abort] => aborting(delete-purse)``: The user aborts the P2P payment. The wallet tries to reclaim money in the purse.
   * ``[purse-timeout] => aborting(refresh)``: The other party was too slow.
@@ -175,7 +175,35 @@ States and transitions:
 Transaction Type: Peer Push Credit
 ----------------------------------
 
-TBD.
+Peer Push Credit transactions are created when the user accepts to be paid via
+a ``taler://pay-push`` URI.
+
+States and transitions:
+
+* ``pending(initial)``
+
+  * ``[processed-success] => pending(withdrawing)``: Merging the reserve was successful
+
+* ``pending(withdrawing)``
+
+  * ``[processed-kyc-required] => kyc-required``
+
+* ``kyc-required``
+
+  * ``[poll-success] => pending(withdrawing)``
+  * ``[action:abort] => aborted``: The user will lose the coins they were not able to withdraw yet, unless they
+    resume the transaction again.
+
+* ``aborted``
+
+  * ``[action:resume] => pending(withdrawing)``
+  * ``[action:delete] => deleted``: The user will irrevocable lose coins that were not withdrawn from the reserve yet.
+
+* ``done``
+
+  * ``[action:delete] => deleted``: No money will be lost, the withdrawn coins will be kept
+
+
 
 Transaction Type: Peer Pull Credit
 ----------------------------------