[GNUnet-SVN] [taler-merchant] branch master updated: caveats to run the payments generator

[gnunet]

This is an automated email from the git hooks/post-receive script.

marcello pushed a commit to branch master
in repository merchant.

The following commit(s) were added to refs/heads/master by this push:
     new 60fb29c  caveats to run the payments generator
60fb29c is described below

commit 60fb29c6fd2ebe69f8597ee810b5a3ae596c6eac
Author: Marcello Stanisci <address@hidden>
AuthorDate: Fri May 5 12:55:08 2017 +0200

    caveats to run the payments generator
---
 doc/manual.texi | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/doc/manual.texi b/doc/manual.texi
index 1a3b487..3298bba 100644
--- a/doc/manual.texi
+++ b/doc/manual.texi
@@ -796,6 +796,44 @@ The option @code{-e} (@code{-m}) avoids any exchange 
(merchant backend) fork,
 and just runs the generator against the exchange (merchant backend) running
 at @code{EURI} (@code{MURI}).
 
+Please NOTE that the generator contains @emph{hardcoded} values, as for deposit
+fees of the coins it uses.  In order to work against the used exchange, those 
values
+MUST match the ones used by the exchange.
+
+The following example shows how the generator "sets" a deposit fee of EUR:0.01
+for the 5 EURO coin.
+
address@hidden
+// from <merchant_repository>/src/sample/generate_payments.c
address@hidden .oc = OC_PAY,
+  .label = "deposit-simple",
+  .expected_response_code = MHD_HTTP_OK,
+  .details.pay.contract_ref = "create-proposal-1",
+  .details.pay.coin_ref = "withdraw-coin-1",
+  .details.pay.amount_with_fee = concat_amount (currency, "5"),
+  .details.pay.amount_without_fee = concat_amount (currency, "4.99") @},
address@hidden example
+
+The logic calculates the deposit fee according to the subtraction:
address@hidden - amount_without_fee}.
+
+The following example shows a 5 EURO coin configuration - needed by the
+used exchange - which is compatible with the hardcoded example above.
+
address@hidden
+[coin_eur_5]
+value = EUR:5
+duration_overlap = 5 minutes
+duration_withdraw = 7 days
+duration_spend = 2 years
+duration_legal = 3 years
+fee_withdraw = EUR:0.00
+fee_deposit = EUR:0.01 # important bit
+fee_refresh = EUR:0.00
+fee_refund = EUR:0.00
+rsa_keysize = 1024
address@hidden example
+
 If the command terminates with no errors, then the merchant backend is 
correctly
 installed.
 

-- 
To stop receiving notification emails like this one, please contact
address@hidden