merchant

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

lookup_all_webhooks.h (2649B)


      1 /*
      2    This file is part of TALER
      3    Copyright (C) 2023 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_webhooks.h
     18  * @brief implementation of the lookup_all_webhooks function for Postgres
     19  * @author Iván Ávalos
     20  */
     21 #ifndef MERCHANT_DATABASE_LOOKUP_ALL_WEBHOOKS_H
     22 #define MERCHANT_DATABASE_LOOKUP_ALL_WEBHOOKS_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_webhooks`.
     31  *
     32  * @param cls a `json_t *` JSON array to build
     33  * @param webhook_serial reference to the configured webhook template.
     34  * @param next_attempt is the time we should make the next request to the webhook.
     35  * @param retries how often have we tried this request to the webhook.
     36  * @param url to make request to
     37  * @param http_method use for the webhook
     38  * @param header of the webhook
     39  * @param body of the webhook
     40  */
     41 typedef void
     42 (*TALER_MERCHANTDB_AllWebhooksCallback)(
     43   void *cls,
     44   uint64_t webhook_serial,
     45   struct GNUNET_TIME_Absolute
     46   next_attempt,
     47   uint32_t retries,
     48   const char *url,
     49   const char *http_method,
     50   const char *header,
     51   const char *body);
     52 
     53 
     54 /**
     55  * Lookup all the webhooks in the ALL webhook.
     56  * Use by the administrator
     57  *
     58  * @param pg database context
     59  * @param instance_id to lookup webhooks for this instance particularly
     60  * @param min_row to see the list of the ALL webhook that it is started with this minimum row.
     61  * @param max_results to see the list of the ALL webhook that it is end with this max results.
     62  * @param cb ALL webhook callback
     63  * @param cb_cls callback closure
     64  */
     65 enum GNUNET_DB_QueryStatus
     66 TALER_MERCHANTDB_lookup_all_webhooks (struct TALER_MERCHANTDB_PostgresContext *pg,
     67                                       const char *instance_id,
     68                                       uint64_t min_row,
     69                                       uint32_t max_results,
     70                                       TALER_MERCHANTDB_AllWebhooksCallback cb,
     71                                       void *cb_cls);
     72 
     73 #endif