From fddd06c15210557997e3ac468ca54677eacbf412 Mon Sep 17 00:00:00 2001
From: Christian Grothoff <christian@grothoff.org>
Date: Sun, 7 May 2023 17:52:46 +0200
Subject: proc doc

---
 doc/flows/int-refund.tex | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 doc/flows/int-refund.tex

(limited to 'doc/flows/int-refund.tex')

diff --git a/doc/flows/int-refund.tex b/doc/flows/int-refund.tex
new file mode 100644
index 00000000..351ecda2
--- /dev/null
+++ b/doc/flows/int-refund.tex
@@ -0,0 +1,39 @@
+\section{Refund}
+
+\begin{figure}[h!]
+  \begin{sequencediagram}
+    \newinst{wallet}{\shortstack{Customer wallet \\
+      \\ \begin{tikzpicture}
+        \node [fill=gray!20,draw=black,thick,align=center] { Unique \\ Wallet ID};
+      \end{tikzpicture}
+    }}
+    \newinst[2]{merchant}{\shortstack{Merchant \\
+       \\ \begin{tikzpicture}[shape aspect=.5]
+        \tikzset{every node/.style={cylinder,shape border rotate=90, draw,fill=gray!25}}
+        \node at (1.5,0) {\shortstack{{{\tiny Database}}}};
+       \end{tikzpicture}
+    }}
+    \newinst[2]{exchange}{\shortstack{Taler (exchange) \\
+       \\ \begin{tikzpicture}[shape aspect=.5]
+        \tikzset{every node/.style={cylinder,shape border rotate=90, draw,fill=gray!25}}
+        \node at (1.5,0) {\shortstack{{{\tiny Database}}}};
+       \end{tikzpicture}
+    }}
+    \postlevel
+    \begin{callself}{merchant}{Initiate refund}{}
+    \end{callself}
+    \mess[0]{merchant}{{Refund offer (QR code)}}{wallet}
+    \mess[0]{wallet}{Request refund}{merchant}
+    \mess[0]{merchant}{Approve refund}{exchange}
+    \mess[0]{exchange}{Confirm refund}{merchant}
+    \mess[0]{merchant}{Return refund confirmation}{wallet}
+  \end{sequencediagram}
+  \caption{Refund processing when a merchant is unable to fulfill
+    a contract.  Refunds must happen {\em before} the
+    exchange has aggregated the original transaction for
+    a bank transfer to the merchant. Furthermore, refunds
+    can only go to the customer who made the original payment
+    and the refund cannot exceed the amount of the original
+    payment.}
+  \label{fig:int:refund}
+\end{figure}
-- 
cgit v1.2.3


From f40932196e9cc710bf00d57bbca7669444165ea5 Mon Sep 17 00:00:00 2001
From: Florian Dold <florian@dold.me>
Date: Sun, 7 May 2023 18:37:24 +0200
Subject: flows: minor edits

---
 contrib/gana                | 2 +-
 doc/flows/int-refund.tex    | 2 +-
 doc/flows/proc-domestic.tex | 8 ++++----
 3 files changed, 6 insertions(+), 6 deletions(-)

(limited to 'doc/flows/int-refund.tex')

diff --git a/contrib/gana b/contrib/gana
index e50e3767..24d50590 160000
--- a/contrib/gana
+++ b/contrib/gana
@@ -1 +1 @@
-Subproject commit e50e37672fae7983fb5e934cd1d381b92648f7b6
+Subproject commit 24d5059048972d4a3f9dc3db1181339d73364c08
diff --git a/doc/flows/int-refund.tex b/doc/flows/int-refund.tex
index 351ecda2..3f11e560 100644
--- a/doc/flows/int-refund.tex
+++ b/doc/flows/int-refund.tex
@@ -23,7 +23,7 @@
     \begin{callself}{merchant}{Initiate refund}{}
     \end{callself}
     \mess[0]{merchant}{{Refund offer (QR code)}}{wallet}
-    \mess[0]{wallet}{Request refund}{merchant}
+    \mess[0]{wallet}{Download refund}{merchant}
     \mess[0]{merchant}{Approve refund}{exchange}
     \mess[0]{exchange}{Confirm refund}{merchant}
     \mess[0]{merchant}{Return refund confirmation}{wallet}
diff --git a/doc/flows/proc-domestic.tex b/doc/flows/proc-domestic.tex
index 6ea43b8e..387b964d 100644
--- a/doc/flows/proc-domestic.tex
+++ b/doc/flows/proc-domestic.tex
@@ -23,8 +23,8 @@
     \mess[0]{sms}{Validation process ID}{exchange}
     \mess[0]{exchange}{Request address validation}{wallet}
     \mess[0]{wallet}{Send address}{sms}
-    \mess[0]{sms}{{Send PIN/TAN code (to address)}}{wallet}
-    \mess[0]{wallet}{Supply PIN/TAN code}{sms}
+    \mess[0]{sms}{{Send confirmation code (to address)}}{wallet}
+    \mess[0]{wallet}{Supply confirmation code}{sms}
     \mess[0]{sms}{{Confirmed customer address}}{exchange}
     \mess[0]{exchange}{{Confirm completion}}{wallet}
     \mess[0]{wallet}{{Retry action}}{exchange}
@@ -45,9 +45,9 @@ supported:
 
 \begin{itemize}
 \item Control over a domestic {\bf mobile phone number} is established
-  by sending an SMS message with a PIN/TAN to the MSIN.
+  by sending an SMS message with a confirmation code to the MSIN.
 \item Control over a domestic {\bf postal address} is established by
-  sending a letter with a PIN/TAN to the address.
+  sending a letter with a confirmation code to the address.
 \end{itemize}
 
 Depending on the type of address, a validation has a limited validity period,
-- 
cgit v1.2.3

