summaryrefslogtreecommitdiff
path: root/manpages/taler-wire-gateway-client.1.rst
diff options
context:
space:
mode:
authorThien-Thi Nguyen <ttn@gnuvola.org>2021-01-08 14:31:00 -0500
committerThien-Thi Nguyen <ttn@gnuvola.org>2021-01-08 14:41:33 -0500
commitbd538d48e93ff3e74986858872dfd3a279e0135c (patch)
tree5be330d03e16bd015cdf8b781a862821878894aa /manpages/taler-wire-gateway-client.1.rst
parent4a0c763410651ee717370e88894bf482f0996c11 (diff)
downloaddocs-bd538d48e93ff3e74986858872dfd3a279e0135c.tar.gz
docs-bd538d48e93ff3e74986858872dfd3a279e0135c.tar.bz2
docs-bd538d48e93ff3e74986858872dfd3a279e0135c.zip
taler-wire-gateway-client(1): rename from taler-bank-transfer(1)
Diffstat (limited to 'manpages/taler-wire-gateway-client.1.rst')
-rw-r--r--manpages/taler-wire-gateway-client.1.rst109
1 files changed, 109 insertions, 0 deletions
diff --git a/manpages/taler-wire-gateway-client.1.rst b/manpages/taler-wire-gateway-client.1.rst
new file mode 100644
index 0000000..cd76d01
--- /dev/null
+++ b/manpages/taler-wire-gateway-client.1.rst
@@ -0,0 +1,109 @@
+taler-wire-gateway-client(1)
+############################
+
+.. only:: html
+
+ Name
+ ====
+
+ **taler-wire-gateway-client** - trigger a transfer at the bank (or obtain transaction history)
+
+Synopsis
+========
+
+**taler-wire-gateway-client**
+[**-a** *VALUE* | **––amount=**\ ‌\ *VALUE*]
+[**-b** *URL* | **––bank=**\ ‌\ *URL*]
+[**-C** *ACCOUNT* | **––credit=**\ ‌\ *ACCOUNT*]
+[**-c** *FILENAME* | **––config=**\ ‌\ *FILENAME*]
+[**-D** *ACCOUNT* | **––debit=**\ ‌\ *ACCOUNT*]
+[**-h** | **––help**]
+[**-i** | **––credit-history**]
+[**-o** | **––debit-history**]
+[**-p** *PASSPHRASE* | **––pass=**\ ‌\ *PASSPHRASE*]
+[**-S** *STRING* | **––subject=**\ ‌\ *STRING*]
+[**-s** *ACCOUNT-SECTION* | **––section=**\ ‌\ *ACCOUNT-SECTION*]
+[**-u** *USERNAME* | **––user=**\ ‌\ *USERNAME*]
+[**-v** | **––version**]
+[**-w** *ROW* | **––since-when=**\ ‌\ *ROW*]
+
+Description
+===========
+
+**taler-wire-gateway-client** is a command-line tool to trigger bank transfers or
+inspect wire transfers for exchange accounts using the wire API. The tool is
+expected to be used during testing or for diagnostics.
+
+You can do one of the following four operations during one invocation.
+
+ (1) Execute wire transfer from the exchange to consumer account (**-C**).
+ (2) Execute wire transfer from consumer account to the exchange (**-D**).
+ (3) Inspect credit history of the exchange (**-i**).
+ (4) Inspect debit history of the exchange (**-o**).
+
+Doing more than one of these at a time will result in an error. Note,
+however, that the **-C** and **-D** options also can be used to act as filters
+on transaction history operations.
+
+
+Options
+=======
+
+**-a** *VALUE* \| **––amount=**\ ‌\ *VALUE*
+ Amount to transfer. Given in the Taler-typical format of
+ CURRENCY:VALUE.FRACTION.
+
+**-b** *URL* \| **––bank=**\ ‌\ *URL*
+ URL at which the bank is operation. Conflicts with **-s**.
+
+**-C** *ACCOUNT* \| **––credit=**\ ‌\ *ACCOUNT*
+ When doing a wire transfer from the exchange, the money should be credited to *ACCOUNT*.
+ Specifies the payto:// URI of the account. Can also be used as a filter by credit
+ account when looking at transaction histories.
+
+**-c** *FILENAME* \| **––config=**\ ‌\ *FILENAME*
+ Use the given configuration file.
+
+**-D** *ACCOUNT* \| **––debit=**\ ‌\ *ACCOUNT*
+ When doing a wire transfer to the exchange, the *ACCOUNT* is to be debited.
+ Specifies the payto:// URI of the account. Can also be used as a filter by debit
+ account when looking at transaction histories.
+
+**-h** \| **––help**
+ Print short help on options.
+
+**-i** \| **––credit-history**
+ Obtain credit history of the exchange. Conflicts with **-o**.
+
+**-o** \| **––debit-history**
+ Obtain debit history of the exchange. Conflicts with **-i**.
+
+**-S** *SUBJECT* \| **––subject=**\ ‌\ *SUBJECT*
+ Use *SUBJECT* for the wire transfer subject. Must be a reserve public key for credit operations and a wire transfer identifier for debit operations. If not specified, a random value will be generated instead.
+
+**-s** *ACCOUNT_SECTION* \| **––section=**\ ‌\ *ACCOUNT-SECTION*
+ Obtain exchange account information from the *ACCOUNT-SECTION* of the configuration. Conflicts with **-u**, **-p** and **-b**. Note that either **-b** or **-s** must be specified.
+
+**-u** *USERNAME* \| **––user=**\ ‌\ *USERNAME*
+ Specifies the username for authentication. Optional and conflicts with **-s**. If neither **-u** nor **-s** are used, we will attempt to talk to the bank without authentication.
+
+**-p** *PASSPHRASE* \| **––pass=**\ ‌\ *PASSPHRASE*
+ Specifies the pass phrase for authentication. Conflicts with **-s**.
+
+**-v** \| **––version**
+ Print version information.
+
+**-w** *ROW* \| **––since-when=**\ ‌\ *ROW*
+ Specifies a *ROW* from which the history should be obtained. If not given, the 10 youngest transactions are returned.
+
+
+See Also
+========
+
+taler-bank-manage(1), taler.conf(5), https://docs.taler.net/core/api-wire.html#wire-transfer-test-apis
+
+Bugs
+====
+
+Report bugs by using https://bugs.taler.net/ or by sending electronic
+mail to <taler@gnu.org>