merchant

Merchant backend to process payments, run by merchants
Log | Files | Refs | Submodules | README | LICENSE

update_money_pot.h (2634B)


      1 /*
      2    This file is part of TALER
      3    Copyright (C) 2025 Taler Systems SA
      4 
      5    TALER is free software; you can redistribute it and/or modify it under the
      6    terms of the GNU General Public License as published by the Free Software
      7    Foundation; either version 3, or (at your option) any later version.
      8 
      9    TALER is distributed in the hope that it will be useful, but WITHOUT ANY
     10    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
     11    A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
     12 
     13    You should have received a copy of the GNU General Public License along with
     14    TALER; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
     15  */
     16 /**
     17  * @file src/include/merchant-database/update_money_pot.h
     18  * @brief implementation of the update_money_pot function for Postgres
     19  * @author Christian Grothoff
     20  */
     21 #ifndef MERCHANT_DATABASE_UPDATE_MONEY_POT_H
     22 #define MERCHANT_DATABASE_UPDATE_MONEY_POT_H
     23 
     24 #include <taler/taler_util.h>
     25 #include <taler/taler_json_lib.h>
     26 #include "merchantdb_lib.h"
     27 
     28 
     29 struct TALER_MERCHANTDB_PostgresContext;
     30 /**
     31  * Update details about a particular money pot.
     32  *
     33  * @param pg database context
     34  * @param instance_id instance to update token family for
     35  * @param money_pot_id serial number of the pot to delete
     36  * @param name set to name of the pot
     37  * @param description set to description of the pot
     38  * @param opt_len length of @a old_pot_totals
     39  * @param old_pot_totals amounts expected currently in the pot,
     40  *        NULL to not check (non-NULL but @a opt_len=0 checks for [])
     41  * @param npt_len length of @a new_pot_totals
     42  * @param new_pot_totals new amounts in the pot,
     43  *        NULL to not update (non-NULL but @a npt_len=0 resets to [])
     44  * @param[out] conflict_total set to true if @a old_pot_total does not match
     45  * @param[out] conflict_name set to true if @a name is used by another pot
     46  * @return database result code
     47  */
     48 enum GNUNET_DB_QueryStatus
     49 TALER_MERCHANTDB_update_money_pot (struct TALER_MERCHANTDB_PostgresContext *pg,
     50                                    const char *instance_id,
     51                                    uint64_t money_pot_id,
     52                                    const char *name,
     53                                    const char *description,
     54                                    size_t opt_len,
     55                                    const struct TALER_Amount *old_pot_totals,
     56                                    size_t npt_len,
     57                                    const struct TALER_Amount *new_pot_totals,
     58                                    bool *conflict_total,
     59                                    bool *conflict_name);
     60 
     61 
     62 #endif