From bb748c56fe5172489bc99e68cda31ba2da4e76b8 Mon Sep 17 00:00:00 2001 From: MS Date: Tue, 10 Jan 2023 16:01:08 +0100 Subject: circuit API document how to test the TAN --- libeufin/api-sandbox.rst | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) (limited to 'libeufin') diff --git a/libeufin/api-sandbox.rst b/libeufin/api-sandbox.rst index 6afcac72..96ca0e0c 100644 --- a/libeufin/api-sandbox.rst +++ b/libeufin/api-sandbox.rst @@ -251,6 +251,17 @@ Cashouts Consult the `cashout rates call `_ to learn about any applicable fee or exchange rate. + To test this operation without relying on any SMS/E-mail provider, + Libeufin offers two methods: defining an environment variable called + ``LIBEUFIN_CASHOUT_TEST_TAN`` or specifying the value ``file`` to + the ``tan_channel`` field of the `request object `_. + Assuming ``LIBEUFIN_CASHOUT_TEST_TAN`` is set to *T*, every */confirm* + operation can use *T* as the TAN. Setting instead the ``tan_channel`` + field to ``file`` will cause the server to (over)write every TAN to + ``/tmp/libeufin-cashout-tan.txt``. If both are used, the environment + variable takes the precedence. + + **Request:** `CashoutRequest `_ @@ -259,7 +270,8 @@ Cashouts enum TanChannel { SMS = "sms", - EMAIL = "email" + EMAIL = "email", + FILE = "file" } .. _cashout-request: -- cgit v1.2.3