account_kyc_set_status.h (3201B)
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 src/include/merchant-database/account_kyc_set_status.h 18 * @brief implementation of the account_kyc_set_status function for Postgres 19 * @author Christian Grothoff 20 */ 21 #ifndef MERCHANT_DATABASE_ACCOUNT_KYC_SET_STATUS_H 22 #define MERCHANT_DATABASE_ACCOUNT_KYC_SET_STATUS_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 an instance's account's KYC status. 32 * 33 * @param pg database context 34 * @param merchant_id merchant backend instance ID 35 * @param h_wire hash of the wire account to check 36 * @param exchange_url base URL of the exchange to check 37 * @param timestamp timestamp to store 38 * @param next_time when should we next check the KYC status 39 * @param kyc_backoff what is the current backoff between KYC status checks 40 * @param exchange_http_status HTTP status code returned last by the exchange 41 * @param exchange_ec_code Taler error code returned last by the exchange 42 * @param rule_gen generation of the rule in the exchange database 43 * (useful for long-polling to wait for rule changes) 44 * @param access_token access token for the KYC process, NULL for none 45 * @param jlimits JSON array with AccountLimits returned by the exchange 46 * @param in_aml_review true if the exchange says the account is under review 47 * @param kyc_ok current KYC status (true for satisfied) 48 * @return database result code 49 */ 50 enum GNUNET_DB_QueryStatus 51 TALER_MERCHANTDB_account_kyc_set_status (struct TALER_MERCHANTDB_PostgresContext *pg, 52 const char *merchant_id, 53 const struct TALER_MerchantWireHashP *h_wire, 54 const char *exchange_url, 55 struct GNUNET_TIME_Timestamp timestamp, 56 struct GNUNET_TIME_Absolute next_time, 57 struct GNUNET_TIME_Relative kyc_backoff, 58 unsigned int exchange_http_status, 59 enum TALER_ErrorCode exchange_ec_code, 60 uint64_t rule_gen, 61 const struct TALER_AccountAccessTokenP *access_token, 62 const json_t *jlimits, 63 bool in_aml_review, 64 bool kyc_ok); 65 66 #endif