summaryrefslogtreecommitdiff
path: root/core/api-bank-conversion-info.rst
diff options
context:
space:
mode:
Diffstat (limited to 'core/api-bank-conversion-info.rst')
-rw-r--r--core/api-bank-conversion-info.rst26
1 files changed, 15 insertions, 11 deletions
diff --git a/core/api-bank-conversion-info.rst b/core/api-bank-conversion-info.rst
index 834cac46..322e9403 100644
--- a/core/api-bank-conversion-info.rst
+++ b/core/api-bank-conversion-info.rst
@@ -48,10 +48,14 @@ is used by wallets for withdrawals that involve a currency conversion.
// https://www.gnu.org/software/libtool/manual/html_node/Versioning.html#Versioning
// The format is "current:revision:age".
version: string;
-
+
// Name of the API.
name: "taler-conversion-info";
+ // URN of the implementation (needed to interpret 'revision' in version).
+ // @since v4, may become mandatory in the future.
+ implementation?: string;
+
// Currency used by this bank.
regional_currency: string;
@@ -65,9 +69,9 @@ is used by wallets for withdrawals that involve a currency conversion.
fiat_currency_specification: CurrencySpecification;
// Additional information on conversion rates.
- // Those informations should never be used to perform conversions,
+ // Those informations should never be used to perform conversions,
// use /cashin-rate or /cashout-rate instead.
- // Conversion rates can change at any time. Clients must deal with
+ // Conversion rates can change at any time. Clients must deal with
// any resulting errors and call /cashin-rate or /cashout-rate again
// to use the new rates.
conversion_rate: ConversionRate;
@@ -91,7 +95,7 @@ is used by wallets for withdrawals that involve a currency conversion.
deducted from their fiat bank account.
or
-
+
:query amount_credit: this is the amount that the user will receive
in their regional bank account.
@@ -100,7 +104,7 @@ is used by wallets for withdrawals that involve a currency conversion.
:http:statuscode:`200 OK`:
Response is a `CashinConversionResponse`.
:http:statuscode:`400 Bad request`:
- * ``TALER_EC_GENERIC_PARAMETER_MISSING`` : none of the parameters have been provided.
+ * ``TALER_EC_GENERIC_PARAMETER_MISSING`` : none of the parameters have been provided.
* ``TALER_EC_GENERIC_PARAMETER_MALFORMED`` : both of the parameters have been provided or one of them is not a valid Taler amount.
* ``TALER_EC_GENERIC_CURRENCY_MISMATCH`` : the parameter is in the wrong currency.
:http:statuscode:`409 Conflict`:
@@ -137,7 +141,7 @@ is used by wallets for withdrawals that involve a currency conversion.
deducted from their regional bank account.
or
-
+
:query amount_credit: this is the amount that the user will receive
in their fiat bank account.
@@ -146,7 +150,7 @@ is used by wallets for withdrawals that involve a currency conversion.
:http:statuscode:`200 OK`:
Response is a `CashoutConversionResponse`.
:http:statuscode:`400 Bad request`:
- * ``TALER_EC_GENERIC_PARAMETER_MISSING`` : none of the parameters have been provided.
+ * ``TALER_EC_GENERIC_PARAMETER_MISSING`` : none of the parameters have been provided.
* ``TALER_EC_GENERIC_PARAMETER_MALFORMED`` : both of the parameters have been provided or one of them is not a valid Taler amount.
* ``TALER_EC_GENERIC_CURRENCY_MISMATCH`` : the parameter is in the wrong currency.
:http:statuscode:`409 Conflict`:
@@ -169,17 +173,17 @@ is used by wallets for withdrawals that involve a currency conversion.
.. http:post:: /conversion-rate
- This endpoint allows the administrator to update
+ This endpoint allows the administrator to update
the exchange rate between the regional currency
and the fiat currency of the banking system.
**Request:**
.. ts:def:: ConversionRate
-
+
interface ConversionRate {
// Exchange rate to buy regional currency from fiat
- cashin_ratio: DecimalNumber;
+ cashin_ratio: DecimalNumber;
// Regional amount fee to subtract after applying the cashin ratio.
cashin_fee: Amount;
@@ -194,7 +198,7 @@ is used by wallets for withdrawals that involve a currency conversion.
cashin_rounding_mode: "zero" | "up" | "nearest";
// Exchange rate to sell regional currency for fiat
- cashout_ratio: DecimalNumber;
+ cashout_ratio: DecimalNumber;
// Fiat amount fee to subtract after applying the cashout ratio.
cashout_fee: Amount;