taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

commit ded20a7da1df51d40bdf4b8a1bf23eb03599f219
parent eb39a79ad1ea0646d05c19a19d3220cd143222f2
Author: Christian Grothoff <christian@grothoff.org>
Date:   Fri,  8 Jan 2021 23:29:05 +0100

Merge branch 'master' of git+ssh://git.taler.net/docs

Diffstat:
Mconf.py | 4++--
Dmanpages/taler-bank-transfer.1.rst | 109-------------------------------------------------------------------------------
Amanpages/taler-wire-gateway-client.1.rst | 118+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
3 files changed, 120 insertions(+), 111 deletions(-)

diff --git a/conf.py b/conf.py @@ -279,8 +279,6 @@ man_pages = [ "setup auditor database", "GNU Taler contributors", 1), ("manpages/taler-auditor.1", "taler-auditor", "audit exchange", "GNU Taler contributors", 1), - ("manpages/taler-bank-transfer.1", "taler-bank-transfer", - "trigger a transfer at the bank", "GNU Taler contributors", 1), ("manpages/taler-config-generate.1", "taler-config-generate", "tool to simplify Taler configuration generation", "GNU Taler contributors", 1), @@ -316,6 +314,8 @@ man_pages = [ ("manpages/taler-merchant-setup-reserve.1", "taler-merchant-setup-reserve", "setup reserve for tipping at a Taler merchant backend", "GNU Taler contributors", 1), + ("manpages/taler-wire-gateway-client.1", "taler-wire-gateway-client", + "trigger a transfer at the bank", "GNU Taler contributors", 1), ("manpages/taler.conf.5", "taler.conf", "Taler configuration file", "GNU Taler contributors", 5), ] diff --git a/manpages/taler-bank-transfer.1.rst b/manpages/taler-bank-transfer.1.rst @@ -1,109 +0,0 @@ -taler-bank-transfer(1) -###################### - -.. only:: html - - Name - ==== - - **taler-bank-transfer** - trigger a transfer at the bank (or obtain transaction history) - -Synopsis -======== - -**taler-bank-transfer** -[**-a** *VALUE* | **––amount=**\ ‌\ *VALUE*] -[**-b** *URL* | **––bank=**\ ‌\ *URL*] -[**-c** *FILENAME* | **––config=**\ ‌\ *FILENAME*] -[**-C** *ACCOUNT* | **––credit=**\ ‌\ *ACCOUNT*] -[**-D** *ACCOUNT* | **––debit=**\ ‌\ *ACCOUNT*] -[**-h** | **––help**] -[**-i** | **––credit-history**] -[**-o** | **––debit-history**] -[**-p** *PASSPHRASE* | **––pass=**\ ‌\ *PASSPHRASE*] -[**-s** *ACCOUNT-SECTION* | **––section=**\ ‌\ *ACCOUNT-SECTION*] -[**-S** *STRING* | **––subject=**\ ‌\ *STRING*] -[**-u** *USERNAME* | **––user=**\ ‌\ *USERNAME*] -[**-v** | **––version**] -[**-w** *ROW* | **––since-when=**\ ‌\ *ROW*] - -Description -=========== - -**taler-bank-transfer** 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** *FILENAME* \| **––config=**\ ‌\ *FILENAME* - Use the given configuration file. - -**-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. - -**-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> diff --git a/manpages/taler-wire-gateway-client.1.rst b/manpages/taler-wire-gateway-client.1.rst @@ -0,0 +1,118 @@ +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**] +[**-L** *LOGLEVEL* | **––loglevel=**\ ‌\ *LOGLEVEL*] +[**-l** *FILENAME* | **––logfile=**\ ‌\ *FILENAME*] +[**-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**. + +**-L** *LOGLEVEL* \| **––loglevel=**\ ‌\ *LOGLEVEL* + Specifies the log level to use. Accepted values are: ``DEBUG``, ``INFO``, + ``WARNING``, ``ERROR``. + +**-l** *FILENAME* \| **––logfile=**\ ‌\ *FILENAME* + Send logging output to *FILENAME*. + +**-o** \| **––debit-history** + Obtain debit history of the exchange. Conflicts with **-i**. + +**-p** *PASSPHRASE* \| **––pass=**\ ‌\ *PASSPHRASE* + Specifies the pass phrase for authentication. Conflicts with **-s**. + +**-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. + +**-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>