merchant

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

merchant_api_patch_template.c (7121B)


      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
      6   it under the terms of the GNU Lesser General Public License as
      7   published by the Free Software Foundation; either version 2.1,
      8   or (at your option) any later version.
      9 
     10   TALER is distributed in the hope that it will be useful,
     11   but WITHOUT ANY WARRANTY; without even the implied warranty of
     12   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     13   GNU Lesser General Public License for more details.
     14 
     15   You should have received a copy of the GNU Lesser General
     16   Public License along with TALER; see the file COPYING.LGPL.
     17   If not, see <http://www.gnu.org/licenses/>
     18 */
     19 /**
     20  * @file merchant_api_patch_template.c
     21  * @brief Implementation of the PATCH /templates/$ID request
     22  *        of the merchant's HTTP API
     23  * @author Priscilla HUANG
     24  */
     25 #include "platform.h"
     26 #include <curl/curl.h>
     27 #include <jansson.h>
     28 #include <microhttpd.h> /* just for HTTP status codes */
     29 #include <gnunet/gnunet_util_lib.h>
     30 #include "taler_merchant_service.h"
     31 #include "merchant_api_common.h"
     32 #include "merchant_api_curl_defaults.h"
     33 #include <taler/taler_json_lib.h>
     34 #include <taler/taler_curl_lib.h>
     35 
     36 
     37 /**
     38  * Handle for a PATCH /templates/$ID operation.
     39  */
     40 struct TALER_MERCHANT_TemplatePatchHandle
     41 {
     42 
     43   /**
     44    * The url for this request.
     45    */
     46   char *url;
     47 
     48   /**
     49    * Handle for the request.
     50    */
     51   struct GNUNET_CURL_Job *job;
     52 
     53   /**
     54    * Function to call with the result.
     55    */
     56   TALER_MERCHANT_TemplatePatchCallback cb;
     57 
     58   /**
     59    * Closure for @a cb.
     60    */
     61   void *cb_cls;
     62 
     63   /**
     64    * Reference to the execution context.
     65    */
     66   struct GNUNET_CURL_Context *ctx;
     67 
     68   /**
     69    * Minor context that holds body and headers.
     70    */
     71   struct TALER_CURL_PostContext post_ctx;
     72 
     73 };
     74 
     75 
     76 /**
     77  * Function called when we're done processing the
     78  * HTTP PATCH /templates/$ID request.
     79  *
     80  * @param cls the `struct TALER_MERCHANT_TemplatePatchHandle`
     81  * @param response_code HTTP response code, 0 on error
     82  * @param response response body, NULL if not in JSON
     83  */
     84 static void
     85 handle_patch_template_finished (void *cls,
     86                                 long response_code,
     87                                 const void *response)
     88 {
     89   struct TALER_MERCHANT_TemplatePatchHandle *tph = cls;
     90   const json_t *json = response;
     91   struct TALER_MERCHANT_HttpResponse hr = {
     92     .http_status = (unsigned int) response_code,
     93     .reply = json
     94   };
     95 
     96   tph->job = NULL;
     97   GNUNET_log (GNUNET_ERROR_TYPE_INFO,
     98               "PATCH /templates/$ID completed with response code %u\n",
     99               (unsigned int) response_code);
    100   switch (response_code)
    101   {
    102   case 0:
    103     hr.ec = TALER_EC_GENERIC_INVALID_RESPONSE;
    104     break;
    105   case MHD_HTTP_NO_CONTENT:
    106     break;
    107   case MHD_HTTP_BAD_REQUEST:
    108     hr.ec = TALER_JSON_get_error_code (json);
    109     hr.hint = TALER_JSON_get_error_hint (json);
    110     GNUNET_break_op (0);
    111     /* This should never happen, either us
    112      * or the merchant is buggy (or API version conflict);
    113      * just pass JSON reply to the application */
    114     break;
    115   case MHD_HTTP_UNAUTHORIZED:
    116     hr.ec = TALER_JSON_get_error_code (json);
    117     hr.hint = TALER_JSON_get_error_hint (json);
    118     /* Nothing really to verify, merchant says we need to authenticate. */
    119     break;
    120   case MHD_HTTP_FORBIDDEN:
    121     hr.ec = TALER_JSON_get_error_code (json);
    122     hr.hint = TALER_JSON_get_error_hint (json);
    123     /* Nothing really to verify, merchant says we tried to abort the payment
    124      * after it was successful. We should pass the JSON reply to the
    125      * application */
    126     break;
    127   case MHD_HTTP_NOT_FOUND:
    128     hr.ec = TALER_JSON_get_error_code (json);
    129     hr.hint = TALER_JSON_get_error_hint (json);
    130     break;
    131   case MHD_HTTP_CONFLICT:
    132     hr.ec = TALER_JSON_get_error_code (json);
    133     hr.hint = TALER_JSON_get_error_hint (json);
    134     break;
    135   case MHD_HTTP_INTERNAL_SERVER_ERROR:
    136     hr.ec = TALER_JSON_get_error_code (json);
    137     hr.hint = TALER_JSON_get_error_hint (json);
    138     /* Server had an internal issue; we should retry,
    139        but this API leaves this to the application */
    140     break;
    141   default:
    142     TALER_MERCHANT_parse_error_details_ (json,
    143                                          response_code,
    144                                          &hr);
    145     /* unexpected response code */
    146     GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
    147                 "Unexpected response code %u/%d\n",
    148                 (unsigned int) response_code,
    149                 (int) hr.ec);
    150     GNUNET_break_op (0);
    151     break;
    152   }
    153   tph->cb (tph->cb_cls,
    154            &hr);
    155   TALER_MERCHANT_template_patch_cancel (tph);
    156 }
    157 
    158 
    159 struct TALER_MERCHANT_TemplatePatchHandle *
    160 TALER_MERCHANT_template_patch (
    161   struct GNUNET_CURL_Context *ctx,
    162   const char *backend_url,
    163   const char *template_id,
    164   const char *template_description,
    165   const char *otp_id,
    166   json_t *template_contract,
    167   TALER_MERCHANT_TemplatePatchCallback cb,
    168   void *cb_cls)
    169 {
    170   struct TALER_MERCHANT_TemplatePatchHandle *tph;
    171   json_t *req_obj;
    172 
    173   req_obj = GNUNET_JSON_PACK (
    174     GNUNET_JSON_pack_string ("template_description",
    175                              template_description),
    176     GNUNET_JSON_pack_allow_null (
    177       GNUNET_JSON_pack_string ("otp_id",
    178                                otp_id)),
    179     GNUNET_JSON_pack_object_incref ("template_contract",
    180                                     (json_t *) template_contract));
    181   tph = GNUNET_new (struct TALER_MERCHANT_TemplatePatchHandle);
    182   tph->ctx = ctx;
    183   tph->cb = cb;
    184   tph->cb_cls = cb_cls;
    185   {
    186     char *path;
    187 
    188     GNUNET_asprintf (&path,
    189                      "private/templates/%s",
    190                      template_id);
    191     tph->url = TALER_url_join (backend_url,
    192                                path,
    193                                NULL);
    194     GNUNET_free (path);
    195   }
    196   if (NULL == tph->url)
    197   {
    198     GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
    199                 "Could not construct request URL.\n");
    200     json_decref (req_obj);
    201     GNUNET_free (tph);
    202     return NULL;
    203   }
    204   {
    205     CURL *eh;
    206 
    207     eh = TALER_MERCHANT_curl_easy_get_ (tph->url);
    208     if (GNUNET_OK !=
    209         TALER_curl_easy_post (&tph->post_ctx,
    210                               eh,
    211                               req_obj))
    212     {
    213       GNUNET_break (0);
    214       curl_easy_cleanup (eh);
    215       json_decref (req_obj);
    216       GNUNET_free (tph);
    217       return NULL;
    218     }
    219     json_decref (req_obj);
    220     GNUNET_assert (CURLE_OK ==
    221                    curl_easy_setopt (eh,
    222                                      CURLOPT_CUSTOMREQUEST,
    223                                      MHD_HTTP_METHOD_PATCH));
    224     tph->job = GNUNET_CURL_job_add2 (ctx,
    225                                      eh,
    226                                      tph->post_ctx.headers,
    227                                      &handle_patch_template_finished,
    228                                      tph);
    229   }
    230   return tph;
    231 }
    232 
    233 
    234 void
    235 TALER_MERCHANT_template_patch_cancel (
    236   struct TALER_MERCHANT_TemplatePatchHandle *tph)
    237 {
    238   if (NULL != tph->job)
    239   {
    240     GNUNET_CURL_job_cancel (tph->job);
    241     tph->job = NULL;
    242   }
    243   TALER_curl_easy_post_finished (&tph->post_ctx);
    244   GNUNET_free (tph->url);
    245   GNUNET_free (tph);
    246 }
    247 
    248 
    249 /* end of merchant_api_patch_template.c */