taler-docs

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

set-donau.rst (768B)

      1 .. ts:op:: setDonau
      2 
      3   Set the donation authority for this wallet.
      4 
      5   **Request:**
      6 
      7     The request arguments must be a `SetDonauRequest` object.
      8 
      9   **Response:**
     10 
     11     On success, the result is an empty object.
     12 
     13   **Side effects:**
     14 
     15     Writes the donation authority configuration to the wallet
     16     database, replacing any previously configured authority.
     17 
     18   **Details:**
     19 
     20     The taxpayer ID is stored together with a salted hash of it (as
     21     defined in LSD0013) that is later used to submit and query
     22     donation receipts.  Repeating the request with an unchanged
     23     ``donauBaseUrl`` and ``taxPayerId`` is idempotent: the existing
     24     salt is kept.
     25 
     26 .. ts:def:: SetDonauRequest
     27 
     28   interface SetDonauRequest {
     29     donauBaseUrl: string;
     30     taxPayerId: string;
     31   }