merchant

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

commit 3493795065b8fde49a5a4c06e5302b2afd03685a
parent e6931be74dc8487d5f3020f265b84145d779b45b
Author: Christian Grothoff <christian@grothoff.org>
Date:   Sat,  2 May 2020 19:25:05 +0200

implement /refund handling

Diffstat:
Msrc/backend/taler-merchant-httpd.c | 27+++++++++++++++++++++++++++
Msrc/backend/taler-merchant-httpd_private-post-orders-ID-refund.c | 6+++---
Msrc/backend/taler-merchant-httpd_private-post-orders-ID-refund.h | 6+++---
Msrc/include/taler_merchant_service.h | 98++++++++++++++++++++++++++++++++++++++++----------------------------------------
Msrc/lib/Makefile.am | 2+-
Asrc/lib/merchant_api_post_order_refund.c | 226+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Dsrc/lib/merchant_api_refund_increase.c | 212-------------------------------------------------------------------------------
7 files changed, 309 insertions(+), 268 deletions(-)

diff --git a/src/backend/taler-merchant-httpd.c b/src/backend/taler-merchant-httpd.c @@ -42,7 +42,10 @@ #include "taler-merchant-httpd_private-post-products.h" #include "taler-merchant-httpd_private-post-products-ID-lock.h" #include "taler-merchant-httpd_private-post-orders.h" +#include "taler-merchant-httpd_private-post-orders-ID-refund.h" +#include "taler-merchant-httpd_post-orders-ID-abort.h" #include "taler-merchant-httpd_post-orders-ID-claim.h" +#include "taler-merchant-httpd_post-orders-ID-pay.h" /** @@ -816,6 +819,14 @@ url_handler (void *cls, .method = MHD_HTTP_METHOD_POST, .handler = &TMH_private_post_orders }, + /* POST /orders/$ID/refund: */ + { + .url_prefix = "/orders/", + .url_suffix = "refund", + .method = MHD_HTTP_METHOD_POST, + .have_id_segment = true, + .handler = &TMH_private_post_orders_ID_refund + }, { NULL } @@ -844,6 +855,14 @@ url_handler (void *cls, .skip_instance = true, .handler = &MH_handler_config }, + /* POST /orders/$ID/abort: */ + { + .url_prefix = "/orders/", + .have_id_segment = true, + .url_suffix = "abort", + .method = MHD_HTTP_METHOD_POST, + .handler = &TMH_post_orders_ID_abort + }, /* POST /orders/$ID/claim: */ { .url_prefix = "/orders/", @@ -852,6 +871,14 @@ url_handler (void *cls, .method = MHD_HTTP_METHOD_POST, .handler = &TMH_post_orders_ID_claim }, + /* POST /orders/$ID/pay: */ + { + .url_prefix = "/orders/", + .have_id_segment = true, + .url_suffix = "pay", + .method = MHD_HTTP_METHOD_POST, + .handler = &TMH_post_orders_ID_pay + }, { NULL } diff --git a/src/backend/taler-merchant-httpd_private-post-orders-ID-refund.c b/src/backend/taler-merchant-httpd_private-post-orders-ID-refund.c @@ -103,9 +103,9 @@ make_taler_refund_uri (struct MHD_Connection *connection, * @return MHD result code */ MHD_RESULT -MH_handler_refund_increase (const struct TMH_RequestHandler *rh, - struct MHD_Connection *connection, - struct TMH_HandlerContext *hc) +TMH_private_post_orders_ID_refund (const struct TMH_RequestHandler *rh, + struct MHD_Connection *connection, + struct TMH_HandlerContext *hc) { struct TALER_Amount refund; const char *reason; diff --git a/src/backend/taler-merchant-httpd_private-post-orders-ID-refund.h b/src/backend/taler-merchant-httpd_private-post-orders-ID-refund.h @@ -35,9 +35,9 @@ * @return MHD result code */ MHD_RESULT -MH_handler_refund_increase (const struct TMH_RequestHandler *rh, - struct MHD_Connection *connection, - struct TMH_HandlerContext *hc); +TMH_private_post_orders_ID_refund (const struct TMH_RequestHandler *rh, + struct MHD_Connection *connection, + struct TMH_HandlerContext *hc); #endif diff --git a/src/include/taler_merchant_service.h b/src/include/taler_merchant_service.h @@ -1735,6 +1735,55 @@ void TALER_MERCHANT_order_abort_cancel (struct TALER_MERCHANT_OrderAbortHandle *oah); +/** + * Handle for a POST /orders/ID/refund operation. + */ +struct TALER_MERCHANT_OrderRefundHandle; + + +/** + * Callback to process a POST /orders/ID/refund request + * + * @param cls closure + * @param http_status HTTP status code for this request + * @param ec taler-specific error code + */ +typedef void +(*TALER_MERCHANT_RefundCallback) ( + void *cls, + const struct TALER_MERCHANT_HttpResponse *hr); + + +/** + * Increase the refund granted for an order + * + * @param ctx the CURL context used to connect to the backend + * @param backend_url backend's base URL, including final "/" + * @param order_id id of the order whose refund is to be increased + * @param refund amount to which increase the refund + * @param reason human-readable reason justifying the refund + * @param cb callback processing the response from /refund + * @param cb_cls closure for cb + */ +struct TALER_MERCHANT_OrderRefundHandle +TALER_MERCHANT_post_order_refund (struct GNUNET_CURL_Context *ctx, + const char *backend_url, + const char *order_id, + const struct TALER_Amount *refund, + const char *reason, + TALER_MERCHANT_RefundCallback cb, + void *cb_cls); + +/** + * Cancel a POST /refund request. + * + * @param rio the refund increasing operation to cancel + */ +void +TALER_MERCHANT_post_order_refund_cancel ( + struct TALER_MERCHANT_OrderRefundHandle *orh); + + /* ********************* OLD ************************** */ @@ -1840,55 +1889,6 @@ TALER_MERCHANT_refund_lookup_cancel ( struct TALER_MERCHANT_RefundLookupOperation *rlo); -/** - * Handle for a POST /refund operation. - */ -struct TALER_MERCHANT_RefundIncreaseOperation; - - -/** - * Callback to process a POST /refund request - * - * @param cls closure - * @param http_status HTTP status code for this request - * @param ec taler-specific error code - */ -typedef void -(*TALER_MERCHANT_RefundIncreaseCallback) ( - void *cls, - const struct TALER_MERCHANT_HttpResponse *hr); - - -/** - * Increase the refund associated to a order - * - * @param ctx the CURL context used to connect to the backend - * @param backend_url backend's base URL, including final "/" - * @param order_id id of the order whose refund is to be increased - * @param refund amount to which increase the refund - * @param reason human-readable reason justifying the refund - * @param cb callback processing the response from /refund - * @param cb_cls closure for cb - */ -struct TALER_MERCHANT_RefundIncreaseOperation * -TALER_MERCHANT_refund_increase (struct GNUNET_CURL_Context *ctx, - const char *backend_url, - const char *order_id, - const struct TALER_Amount *refund, - const char *reason, - TALER_MERCHANT_RefundIncreaseCallback cb, - void *cb_cls); - -/** - * Cancel a POST /refund request. - * - * @param rio the refund increasing operation to cancel - */ -void -TALER_MERCHANT_refund_increase_cancel ( - struct TALER_MERCHANT_RefundIncreaseOperation *rio); - - /* ********************* /proposal *********************** */ diff --git a/src/lib/Makefile.am b/src/lib/Makefile.am @@ -31,12 +31,12 @@ libtalermerchant_la_SOURCES = \ merchant_api_post_orders.c \ merchant_api_post_order_claim.c \ merchant_api_post_order_pay.c \ + merchant_api_post_order_refund.c \ \ merchant_api_check_payment.c \ merchant_api_history.c \ merchant_api_poll_payment.c \ merchant_api_refund.c \ - merchant_api_refund_increase.c \ merchant_api_tip_authorize.c \ merchant_api_tip_pickup.c \ merchant_api_tip_pickup2.c \ diff --git a/src/lib/merchant_api_post_order_refund.c b/src/lib/merchant_api_post_order_refund.c @@ -0,0 +1,226 @@ +/* + This file is part of TALER + Copyright (C) 2014, 2015, 2016, 2017, 2019, 2020 Taler Systems SA + + TALER is free software; you can redistribute it and/or modify it under the + terms of the GNU Lesser General Public License as published by the Free Software + Foundation; either version 2.1, or (at your option) any later version. + + TALER is distributed in the hope that it will be useful, but WITHOUT ANY + WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR + A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public License along with + TALER; see the file COPYING.LGPL. If not, see + <http://www.gnu.org/licenses/> +*/ +/** + * @file lib/merchant_api_post_order_refund.c + * @brief Implementation of the POST /orders/ID/refund request + * @author Christian Grothoff + * @author Marcello Stanisci + */ +#include "platform.h" +#include <curl/curl.h> +#include <jansson.h> +#include <microhttpd.h> /* just for HTTP status codes */ +#include <gnunet/gnunet_util_lib.h> +#include <gnunet/gnunet_curl_lib.h> +#include "taler_merchant_service.h" +#include <taler/taler_json_lib.h> +#include <taler/taler_signatures.h> +#include <taler/taler_curl_lib.h> + + +/** + * Handle for a POST /orders/ID/refund operation. + */ +struct TALER_MERCHANT_OrderRefundHandle +{ + /** + * Complete URL where the backend offers /refund + */ + char *url; + + /** + * Minor context that holds body and headers. + */ + struct TALER_CURL_PostContext post_ctx; + + /** + * The CURL context to connect to the backend + */ + struct GNUNET_CURL_Context *ctx; + + /** + * The callback to pass the backend response to + */ + TALER_MERCHANT_RefundCallback cb; + + /** + * Clasure to pass to the callback + */ + void *cb_cls; + + /** + * Handle for the request + */ + struct GNUNET_CURL_Job *job; +}; + + +/** + * Callback to process POST /orders/ID/refund response + * + * @param cls the `struct TALER_MERCHANT_OrderRefundHandle` + * @param response_code HTTP response code, 0 on error + * @param json response body, NULL if not JSON + */ +static void +handle_refund_finished (void *cls, + long response_code, + const void *response) +{ + struct TALER_MERCHANT_OrderRefundHandle *orh = cls; + const json_t *json = response; + struct TALER_MERCHANT_HttpResponse hr = { + .http_status = (unsigned int) response_code, + .reply = json + }; + + orh->job = NULL; + switch (response_code) + { + case 0: + hr.ec = TALER_EC_INVALID_RESPONSE; + orh->cb (orh->cb_cls, + &hr); + break; + case MHD_HTTP_OK: + orh->cb (orh->cb_cls, + &hr); + break; + case MHD_HTTP_CONFLICT: + case MHD_HTTP_NOT_FOUND: + hr.ec = TALER_JSON_get_error_code (json); + hr.hint = TALER_JSON_get_error_hint (json); + orh->cb (orh->cb_cls, + &hr); + break; + default: + GNUNET_break_op (0); /* unexpected status code */ + TALER_MERCHANT_parse_error_details_ (json, + response_code, + &hr); + orh->cb (orh->cb_cls, + &hr); + break; + } + TALER_MERCHANT_post_order_refund_cancel (orh); +} + + +/** + * Cancel a POST /orders/ID/refund request. + * + * @param orh the refund increasing operation to cancel + */ +void +TALER_MERCHANT_post_order_refund_cancel ( + struct TALER_MERCHANT_OrderRefundHandle *orh) +{ + if (NULL != orh->job) + { + GNUNET_CURL_job_cancel (orh->job); + orh->job = NULL; + } + TALER_curl_easy_post_finished (&orh->post_ctx); + GNUNET_free (orh->url); + GNUNET_free (orh); +} + + +/** + * Increase the refund granted for an order + * + * @param ctx the CURL context used to connect to the backend + * @param backend_url backend's base URL, including final "/" + * @param order_id id of the order whose refund is to be increased + * @param refund amount to which increase the refund + * @param reason human-readable reason justifying the refund + * @param cb callback processing the response from /refund + * @param cb_cls closure for cb + */ +struct TALER_MERCHANT_OrderRefundHandle * +TALER_MERCHANT_order_refund (struct GNUNET_CURL_Context *ctx, + const char *backend_url, + const char *order_id, + const struct TALER_Amount *refund, + const char *reason, + TALER_MERCHANT_RefundCallback cb, + void *cb_cls) +{ + struct TALER_MERCHANT_OrderRefundHandle *orh; + json_t *req; + CURL *eh; + + orh = GNUNET_new (struct TALER_MERCHANT_OrderRefundHandle); + orh->ctx = ctx; + orh->cb = cb; + orh->cb_cls = cb_cls; + { + char *path; + + GNUNET_asprintf (&path, + "private/orders/%s/refund", + order_id); + orh->url = TALER_url_join (backend_url, + path, + NULL); + GNUNET_free (path); + } + if (NULL == orh->url) + { + GNUNET_log (GNUNET_ERROR_TYPE_ERROR, + "Could not construct request URL.\n"); + GNUNET_free (orh); + return NULL; + } + req = json_pack ("{s:o, s:s}", + "refund", TALER_JSON_from_amount (refund), + "reason", reason); + GNUNET_assert (NULL != req); + eh = curl_easy_init (); + GNUNET_assert (NULL != eh); + if (GNUNET_OK != + TALER_curl_easy_post (&orh->post_ctx, + eh, + req)) + { + GNUNET_break (0); + json_decref (req); + GNUNET_free (orh->url); + GNUNET_free (orh); + return NULL; + } + json_decref (req); + GNUNET_assert (CURLE_OK == + curl_easy_setopt (eh, + CURLOPT_URL, + orh->url)); + orh->job = GNUNET_CURL_job_add2 (ctx, + eh, + orh->post_ctx.headers, + &handle_refund_finished, + orh); + if (NULL == orh->job) + { + GNUNET_free (orh->url); + GNUNET_free (orh); + return NULL; + } + return orh; +} + + +/* end of merchant_api_post_order_refund.c */ diff --git a/src/lib/merchant_api_refund_increase.c b/src/lib/merchant_api_refund_increase.c @@ -1,212 +0,0 @@ -/* - This file is part of TALER - Copyright (C) 2014, 2015, 2016, 2017, 2019, 2020 Taler Systems SA - - TALER is free software; you can redistribute it and/or modify it under the - terms of the GNU Lesser General Public License as published by the Free Software - Foundation; either version 2.1, or (at your option) any later version. - - TALER is distributed in the hope that it will be useful, but WITHOUT ANY - WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR - A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public License along with - TALER; see the file COPYING.LGPL. If not, see - <http://www.gnu.org/licenses/> -*/ -/** - * @file lib/merchant_api_refund_increase.c - * @brief Implementation of the /refund POST and GET - * @author Christian Grothoff - * @author Marcello Stanisci - */ -#include "platform.h" -#include <curl/curl.h> -#include <jansson.h> -#include <microhttpd.h> /* just for HTTP status codes */ -#include <gnunet/gnunet_util_lib.h> -#include <gnunet/gnunet_curl_lib.h> -#include "taler_merchant_service.h" -#include <taler/taler_json_lib.h> -#include <taler/taler_signatures.h> -#include <taler/taler_curl_lib.h> - - -struct TALER_MERCHANT_RefundIncreaseOperation -{ - /** - * Complete URL where the backend offers /refund - */ - char *url; - - /** - * Minor context that holds body and headers. - */ - struct TALER_CURL_PostContext post_ctx; - - /** - * The CURL context to connect to the backend - */ - struct GNUNET_CURL_Context *ctx; - - /** - * The callback to pass the backend response to - */ - TALER_MERCHANT_RefundIncreaseCallback cb; - - /** - * Clasure to pass to the callback - */ - void *cb_cls; - - /** - * Handle for the request - */ - struct GNUNET_CURL_Job *job; -}; - - -/** - * Callback to process POST /refund response - * - * @param cls the `struct TALER_MERCHANT_RefundIncreaseOperation` - * @param response_code HTTP response code, 0 on error - * @param json response body, NULL if not JSON - */ -static void -handle_refund_increase_finished (void *cls, - long response_code, - const void *response) -{ - struct TALER_MERCHANT_RefundIncreaseOperation *rio = cls; - const json_t *json = response; - struct TALER_MERCHANT_HttpResponse hr = { - .http_status = (unsigned int) response_code, - .reply = json - }; - - rio->job = NULL; - switch (response_code) - { - case 0: - hr.ec = TALER_EC_INVALID_RESPONSE; - rio->cb (rio->cb_cls, - &hr); - break; - case MHD_HTTP_OK: - rio->cb (rio->cb_cls, - &hr); - break; - case MHD_HTTP_CONFLICT: - case MHD_HTTP_NOT_FOUND: - hr.ec = TALER_JSON_get_error_code (json); - hr.hint = TALER_JSON_get_error_hint (json); - rio->cb (rio->cb_cls, - &hr); - break; - default: - GNUNET_break_op (0); /* unexpected status code */ - TALER_MERCHANT_parse_error_details_ (json, - response_code, - &hr); - rio->cb (rio->cb_cls, - &hr); - break; - } - TALER_MERCHANT_refund_increase_cancel (rio); -} - - -/** - * Cancel a POST /refund request. - * - * @param rio the refund increasing operation to cancel - */ -void -TALER_MERCHANT_refund_increase_cancel ( - struct TALER_MERCHANT_RefundIncreaseOperation *rio) -{ - if (NULL != rio->job) - { - GNUNET_CURL_job_cancel (rio->job); - rio->job = NULL; - } - TALER_curl_easy_post_finished (&rio->post_ctx); - GNUNET_free (rio->url); - GNUNET_free (rio); -} - - -/** - * Increase the refund associated to a order - * - * @param ctx the CURL context used to connect to the backend - * @param backend_url backend's base URL, including final "/" - * @param order_id id of the order whose refund is to be increased - * @param refund amount to which increase the refund - * @param reason human-readable reason justifying the refund - * @param cb callback processing the response from /refund - * @param cb_cls closure for cb - */ -struct TALER_MERCHANT_RefundIncreaseOperation * -TALER_MERCHANT_refund_increase (struct GNUNET_CURL_Context *ctx, - const char *backend_url, - const char *order_id, - const struct TALER_Amount *refund, - const char *reason, - TALER_MERCHANT_RefundIncreaseCallback cb, - void *cb_cls) -{ - struct TALER_MERCHANT_RefundIncreaseOperation *rio; - json_t *req; - CURL *eh; - - rio = GNUNET_new (struct TALER_MERCHANT_RefundIncreaseOperation); - rio->ctx = ctx; - rio->cb = cb; - rio->cb_cls = cb_cls; - rio->url = TALER_url_join (backend_url, - "refund", - NULL); - if (NULL == rio->url) - { - GNUNET_log (GNUNET_ERROR_TYPE_ERROR, - "Could not construct request URL.\n"); - GNUNET_free (rio); - return NULL; - } - - req = json_pack ("{s:o, s:s, s:s}", - "refund", TALER_JSON_from_amount (refund), - "order_id", order_id, - "reason", reason); - eh = curl_easy_init (); - - if (GNUNET_OK != TALER_curl_easy_post (&rio->post_ctx, - eh, - req)) - { - GNUNET_break (0); - json_decref (req); - GNUNET_free (rio->url); - GNUNET_free (rio); - return NULL; - } - json_decref (req); - GNUNET_assert (CURLE_OK == curl_easy_setopt (eh, - CURLOPT_URL, - rio->url)); - rio->job = GNUNET_CURL_job_add2 - (ctx, - eh, - rio->post_ctx.headers, - &handle_refund_increase_finished, - rio); - if (NULL == rio->job) - { - GNUNET_free (rio->url); - GNUNET_free (rio); - return NULL; - } - return rio; -}