From 4a031a692b962483d9ebc04f6d2526e192f1c7cd Mon Sep 17 00:00:00 2001
From: Christian Grothoff <christian@grothoff.org>
Date: Wed, 4 May 2016 09:42:52 +0200
Subject: implementing /refund API (#3848)

---
 src/include/taler_signatures.h | 63 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

(limited to 'src/include/taler_signatures.h')

diff --git a/src/include/taler_signatures.h b/src/include/taler_signatures.h
index e338916e1..c31cc6b93 100644
--- a/src/include/taler_signatures.h
+++ b/src/include/taler_signatures.h
@@ -117,6 +117,11 @@
  */
 #define TALER_SIGNATURE_EXCHANGE_CONFIRM_WIRE_DEPOSIT 1037
 
+/**
+ * Signature where the Exchange confirms a refund request.
+ */
+#define TALER_SIGNATURE_EXCHANGE_CONFIRM_REFUND 1038
+
 
 /*********************/
 /* Wallet signatures */
@@ -453,6 +458,64 @@ struct TALER_RefundRequestPS
 };
 
 
+/**
+ * @brief Format used to generate the signature on a request to refund
+ * a coin into the account of the customer.
+ */
+struct TALER_RefundConfirmationPS
+{
+  /**
+   * Purpose must be #TALER_SIGNATURE_EXCHANGE_CONFIRM_REFUND.
+   */
+  struct GNUNET_CRYPTO_EccSignaturePurpose purpose;
+
+  /**
+   * Hash over the contract which is being refunded.
+   */
+  struct GNUNET_HashCode h_contract GNUNET_PACKED;
+
+  /**
+   * Merchant-generated transaction ID of the orginal transaction.
+   */
+  uint64_t transaction_id GNUNET_PACKED;
+
+  /**
+   * The coin's public key.  This is the value that must have been
+   * signed (blindly) by the Exchange.
+   */
+  struct TALER_CoinSpendPublicKeyP coin_pub;
+
+  /**
+   * The Merchant's public key.  Allows the merchant to later refund
+   * the transaction or to inquire about the wire transfer identifier.
+   */
+  struct TALER_MerchantPublicKeyP merchant;
+
+  /**
+   * Merchant-generated transaction ID for the refund.
+   */
+  uint64_t rtransaction_id GNUNET_PACKED;
+
+  /**
+   * Amount to be refunded, including refund fee charged by the
+   * exchange to the customer.
+   */
+  struct TALER_AmountNBO refund_amount;
+
+  /**
+   * Refund fee charged by the exchange.  This must match the
+   * Exchange's denomination key's refund fee.  If the client puts in
+   * an invalid refund fee (too high or too low) that does not match
+   * the Exchange's denomination key, the refund operation is invalid
+   * and will be rejected by the exchange.  The @e amount_with_fee
+   * minus the @e refund_fee is the amount that will be credited to
+   * the original coin.
+   */
+  struct TALER_AmountNBO refund_fee;
+
+};
+
+
 /**
  * @brief Message signed by a coin to indicate that the coin should be
  * melted.
-- 
cgit v1.2.3