merchant

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

lookup_all_products.h (2113B)


      1 /*
      2    This file is part of TALER
      3    Copyright (C) 2024 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/lookup_all_products.h
     18  * @brief implementation of the lookup_all_products function for Postgres
     19  * @author Christian Grothoff
     20  */
     21 #ifndef MERCHANT_DATABASE_LOOKUP_ALL_PRODUCTS_H
     22 #define MERCHANT_DATABASE_LOOKUP_ALL_PRODUCTS_H
     23 
     24 #include <taler/taler_util.h>
     25 #include <taler/taler_json_lib.h>
     26 #include "merchantdb_lib.h"
     27 
     28 
     29 /**
     30  * Typically called by `lookup_all_products`.
     31  *
     32  * @param cls a `json_t *` JSON array to build
     33  * @param product_serial row ID of the product
     34  * @param product_id ID of the product
     35  * @param pd full product details
     36  * @param num_categories length of @a categories array
     37  * @param categories array of categories the
     38  *   product is in
     39  */
     40 typedef void
     41 (*TALER_MERCHANTDB_ProductCallback)(
     42   void *cls,
     43   uint64_t product_serial,
     44   const char *product_id,
     45   const struct TALER_MERCHANTDB_ProductDetails *pd,
     46   size_t num_categories,
     47   const uint64_t *categories);
     48 
     49 /**
     50  * Lookup all of the products the given instance has configured.
     51  *
     52  * @param pg database context
     53  * @param instance_id instance to lookup products for
     54  * @param cb function to call on all products found
     55  * @param cb_cls closure for @a cb
     56  * @return database result code
     57  */
     58 enum GNUNET_DB_QueryStatus
     59 TALER_MERCHANTDB_lookup_all_products (
     60   struct TALER_MERCHANTDB_PostgresContext *pg,
     61   const char *instance_id,
     62   TALER_MERCHANTDB_ProductCallback cb,
     63   void *cb_cls);
     64 
     65 #endif