aboutsummaryrefslogtreecommitdiff
path: root/src/include/taler_exchange_service.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/include/taler_exchange_service.h')
-rw-r--r--src/include/taler_exchange_service.h72
1 files changed, 36 insertions, 36 deletions
diff --git a/src/include/taler_exchange_service.h b/src/include/taler_exchange_service.h
index 5834d2a6f..1c29e15c1 100644
--- a/src/include/taler_exchange_service.h
+++ b/src/include/taler_exchange_service.h
@@ -965,9 +965,9 @@ enum TALER_EXCHANGE_ReserveTransactionType
TALER_EXCHANGE_RTT_WITHDRAWAL,
/**
- * /payback operation.
+ * /recoup operation.
*/
- TALER_EXCHANGE_RTT_PAYBACK,
+ TALER_EXCHANGE_RTT_RECOUP,
/**
* Reserve closed operation.
@@ -1034,8 +1034,8 @@ struct TALER_EXCHANGE_ReserveHistory
json_t *out_authorization_sig;
/**
- * Information provided if the reserve was filled via /payback.
- * @e type is #TALER_EXCHANGE_RTT_PAYBACK.
+ * Information provided if the reserve was filled via /recoup.
+ * @e type is #TALER_EXCHANGE_RTT_RECOUP.
*/
struct
{
@@ -1047,7 +1047,7 @@ struct TALER_EXCHANGE_ReserveHistory
/**
* Signature of the coin of type
- * #TALER_SIGNATURE_EXCHANGE_CONFIRM_PAYBACK.
+ * #TALER_SIGNATURE_EXCHANGE_CONFIRM_RECOUP.
*/
struct TALER_ExchangeSignatureP exchange_sig;
@@ -1057,11 +1057,11 @@ struct TALER_EXCHANGE_ReserveHistory
struct TALER_ExchangePublicKeyP exchange_pub;
/**
- * When did the /payback operation happen?
+ * When did the /recoup operation happen?
*/
struct GNUNET_TIME_Absolute timestamp;
- } payback_details;
+ } recoup_details;
/**
* Information about a close operation of the reserve.
@@ -1722,13 +1722,13 @@ TALER_EXCHANGE_verify_coin_history (const struct
struct TALER_Amount *total);
-/* ********************* /payback *********************** */
+/* ********************* /recoup *********************** */
/**
- * @brief A /payback Handle
+ * @brief A /recoup Handle
*/
-struct TALER_EXCHANGE_PaybackHandle;
+struct TALER_EXCHANGE_RecoupHandle;
/**
@@ -1745,27 +1745,27 @@ struct TALER_EXCHANGE_PaybackHandle;
* @param ec taler-specific error code, #TALER_EC_NONE on success
* @param amount amount the exchange will wire back for this coin,
* on error the total balance remaining, or NULL
- * @param timestamp what time did the exchange receive the /payback request
- * @param reserve_pub public key of the reserve receiving the payback, NULL if refreshed or on error
+ * @param timestamp what time did the exchange receive the /recoup request
+ * @param reserve_pub public key of the reserve receiving the recoup, NULL if refreshed or on error
* @param old_coin_pub public key of the dirty coin, NULL if not refreshed or on error
* @param full_response full response from the exchange (for logging, in case of errors)
*/
typedef void
-(*TALER_EXCHANGE_PaybackResultCallback) (void *cls,
- unsigned int http_status,
- enum TALER_ErrorCode ec,
- const struct TALER_Amount *amount,
- struct GNUNET_TIME_Absolute timestamp,
- const struct
- TALER_ReservePublicKeyP *reserve_pub,
- const struct
- TALER_CoinSpendPublicKeyP *old_coin_pub,
- const json_t *full_response);
+(*TALER_EXCHANGE_RecoupResultCallback) (void *cls,
+ unsigned int http_status,
+ enum TALER_ErrorCode ec,
+ const struct TALER_Amount *amount,
+ struct GNUNET_TIME_Absolute timestamp,
+ const struct
+ TALER_ReservePublicKeyP *reserve_pub,
+ const struct
+ TALER_CoinSpendPublicKeyP *old_coin_pub,
+ const json_t *full_response);
/**
* Ask the exchange to pay back a coin due to the exchange triggering
- * the emergency payback protocol for a given denomination. The value
+ * the emergency recoup protocol for a given denomination. The value
* of the coin will be refunded to the original customer (without fees).
*
* @param exchange the exchange handle; the exchange must be ready to operate
@@ -1773,30 +1773,30 @@ typedef void
* @param denom_sig signature over the coin by the exchange using @a pk
* @param ps secret internals of the original planchet
* @param was_refreshed #GNUNET_YES if the coin in @a ps was refreshed
- * @param payback_cb the callback to call when the final result for this request is available
- * @param payback_cb_cls closure for @a payback_cb
+ * @param recoup_cb the callback to call when the final result for this request is available
+ * @param recoup_cb_cls closure for @a recoup_cb
* @return NULL
* if the inputs are invalid (i.e. denomination key not with this exchange).
* In this case, the callback is not called.
*/
-struct TALER_EXCHANGE_PaybackHandle *
-TALER_EXCHANGE_payback (struct TALER_EXCHANGE_Handle *exchange,
- const struct TALER_EXCHANGE_DenomPublicKey *pk,
- const struct TALER_DenominationSignature *denom_sig,
- const struct TALER_PlanchetSecretsP *ps,
- int was_refreshed,
- TALER_EXCHANGE_PaybackResultCallback payback_cb,
- void *payback_cb_cls);
+struct TALER_EXCHANGE_RecoupHandle *
+TALER_EXCHANGE_recoup (struct TALER_EXCHANGE_Handle *exchange,
+ const struct TALER_EXCHANGE_DenomPublicKey *pk,
+ const struct TALER_DenominationSignature *denom_sig,
+ const struct TALER_PlanchetSecretsP *ps,
+ int was_refreshed,
+ TALER_EXCHANGE_RecoupResultCallback recoup_cb,
+ void *recoup_cb_cls);
/**
- * Cancel a payback request. This function cannot be used on a
+ * Cancel a recoup request. This function cannot be used on a
* request handle if the callback was already invoked.
*
- * @param ph the payback handle
+ * @param ph the recoup handle
*/
void
-TALER_EXCHANGE_payback_cancel (struct TALER_EXCHANGE_PaybackHandle *ph);
+TALER_EXCHANGE_recoup_cancel (struct TALER_EXCHANGE_RecoupHandle *ph);
#endif /* _TALER_EXCHANGE_SERVICE_H */