regional tutorial: merchant instructions

how to create the default instance and add the banking details

5 files changed, 37 insertions, 0 deletions

diff --git a/libeufin/enter_instance_details.png b/libeufin/enter_instance_details.png
new file mode 100644
index 00000000..f2177091
--- /dev/null
+++ b/libeufin/enter_instance_details.png
diff --git a/libeufin/instance_iban_config.png b/libeufin/instance_iban_config.png
new file mode 100644
index 00000000..03fa8f36
--- /dev/null
+++ b/libeufin/instance_iban_config.png
diff --git a/libeufin/merchant_first_login.png b/libeufin/merchant_first_login.png
new file mode 100644
index 00000000..0baa0801
--- /dev/null
+++ b/libeufin/merchant_first_login.png
diff --git a/libeufin/no_default_account_yet.png b/libeufin/no_default_account_yet.png
new file mode 100644
index 00000000..c97c231d
--- /dev/null
+++ b/libeufin/no_default_account_yet.png
diff --git a/libeufin/regional-manual.rst b/libeufin/regional-manual.rst
index 2892cac2..34f140a9 100644
--- a/libeufin/regional-manual.rst
+++ b/libeufin/regional-manual.rst
@@ -280,4 +280,41 @@ amount of regional currency. The conversion triggers will inform Nexus
 about the destruction, and Nexus will then wire the corresponding amount
 in fiat to the associated fiat bank account.
 
+Merchant setup
+--------------
+
+In order to setup a shop, you need a merchant backend to run.  The installation
+installs and sets one backend up, but the user is required to complete the shop
+configuration via the Web browser.
+
+One fundamental piece of information are the banking details, to allow merchant
+receive payments from the exchange.  If you haven't already registered one bank
+account at the regional bank, do at ``$proto://bank.$domain_name/`` and take note
+of the IBAN you just got assigned.  After having registered a new account, you
+can see your IBAN by clicking on the ``Welcome, $USERNAME`` message in the profile
+page.  The IBAN is shown under the ``Internal IBAN`` box.
+
+Next, point your browser to ``$proto://backend.$domain_name/``.  You should
+be welcomed by the following page:
+
+.. image:: merchant_first_login.png
+
+Such page offers to create a merchant profile: fill any required field (including
+your access token) and clik to ``confirm``.  It should now be possible to associate
+the banking details to the profile just created: click to ``Bank account`` at the
+left of the page.  The following page should be shown:
+
+.. image:: no_default_account_yet.png
+
+Click on the blue "+" sign on the top right of the page, and expect the following
+page to appear:
+
+.. image:: enter_instance_details.png
+
+This tutorial is focused on IBAN, so choose ``iban`` as the account type, and
+expect the following page to appear:
+
+.. image:: instance_iban_config.png
 
+After providing the details and confirming, the shop is ready to generate orders
+and accept payments.