merchant

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

pg_lookup_transfers.h (2563B)


      1 /*
      2    This file is part of TALER
      3    Copyright (C) 2022 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 backenddb/pg_lookup_transfers.h
     18  * @brief implementation of the lookup_transfers function for Postgres
     19  * @author Christian Grothoff
     20  */
     21 #ifndef PG_LOOKUP_TRANSFERS_H
     22 #define PG_LOOKUP_TRANSFERS_H
     23 
     24 #include <taler/taler_util.h>
     25 #include <taler/taler_json_lib.h>
     26 #include "taler_merchantdb_plugin.h"
     27 
     28 /**
     29  * Lookup transfers. Note that filtering by @a verified status is done
     30  * outside of SQL, as we already have 8 prepared statements and adding
     31  * a filter on verified would further double the number of statements for
     32  * a likely rather ineffective filter. So we apply that filter in
     33  * #lookup_transfers_cb().
     34  *
     35  * @param cls closure
     36  * @param instance_id instance to lookup payments for
     37  * @param payto_uri account that we are interested in transfers to
     38  * @param before timestamp for the earliest transfer we care about
     39  * @param after timestamp for the last transfer we care about
     40  * @param limit number of entries to return, negative for descending in execution time,
     41  *                positive for ascending in execution time
     42  * @param offset transfer_serial number of the transfer we want to offset from
     43  * @param expected filter for transfers that were expected
     44  * @param cb function to call with detailed transfer data
     45  * @param cb_cls closure for @a cb
     46  * @return transaction status
     47  */
     48 enum GNUNET_DB_QueryStatus
     49 TMH_PG_lookup_transfers (void *cls,
     50                          const char *instance_id,
     51                          struct TALER_FullPayto payto_uri,
     52                          struct GNUNET_TIME_Timestamp before,
     53                          struct GNUNET_TIME_Timestamp after,
     54                          int64_t limit,
     55                          uint64_t offset,
     56                          enum TALER_EXCHANGE_YesNoAll expected,
     57                          TALER_MERCHANTDB_TransferCallback cb,
     58                          void *cb_cls);
     59 
     60 #endif