taler-merchant-setup-reserve(1)
###############################


.. only:: html

  Name
  ====

  **taler-merchant-setup-reserve** - setup reserve for tipping


Synopsis
========

**taler-merchant-setup-reserve** [*options*]


Description
===========

**taler-merchant-setup-reserve** is a command line tool to setup a reserve
(creating the private reserve key) and obtaining the wire transfer information
from the exchange needed to fill the reserve.


Options
=======

-a VALUE, --amount=VALUE
       Amount to be transferred to the reserve. Mandatory.

-A USERNAME:PASSWORD, --auth=USERNAME:PASSWORD
       Use USERNAME and PASSWORD for HTTP client authentication. The ":" must be present as a separator. Note that this form of authentication has nothing to do with the TLS client certificate authentication supported with the "-C", "-k" and "-p" options.  The PASSWORD given to this option is given to the server! Optional.

-C CERTFILE, --cert=CERTFILE
       The specified CERTFILE contains a TLS client certificate to be used to authenticate the client. Optional.  See also "-t".

-e URL, --exchange-url=URL
       Use URL for the exchange base URL. This is the exchange where
       the reserve will be created. The currency used in the amount
       specification must be offered by this exchange.  Mandatory.

-k KEYFILE, --key=KEYFILE
       The specified KEYFILE contains a TLS client private key to be used to authenticate the client. Optional.  See also "-p" and "-C".

-m URL, --merchant-url=URL
       Use URL as the merchant base URL.  Should include the path to
       the instance if the reserve is to be created for a non-default instance.
       Mandatory.

-p KEYFILEPASSPHRASE, --pass=KEYFILEPASSPHRASE
       The specified KEYFILEPASSPHRASE is to be used to decrypt the KEYFILE. Optional.  See also "-k". Not to be confused with "-A".  The KEYFILEPASSPHRASE given here is only used locally to decrypt the KEYFILE.

-t CERTTYPE, --type=CERTTYPE
       The specified CERTFILE contains a TLS client certificate of CERTTYPE. Default is "PEM". Optional.  See also "-C".

-w METHOD, --wire-method=METHOD
       Which wire method should be used. Needed to select the wire
       transfer method of the exchange. The method must be supported
       by the exchange. Typical values would be "iban" or "x-taler-bank".
       Mandatory.

-c FILENAME, --config=FILENAME
       Use the configuration and other resources for the merchant to
       operate from FILENAME.

-h, --help
       Print short help on options.

-v, --version
       Print version information.

-l LF, --logfile=LF
       Sends logs to file whose path is LF.

-L LOGLEVEL, --log=LOGLEVEL
       Use loglevel LOGLEVEL.


Bugs
====

Report bugs by using https://bugs.taler.net/ or by sending electronic
mail to <taler@gnu.org>.


See Also
========

taler-merchant-dbinit(1), taler.conf(5)