crypto_pay_api/models/transfer/
params.rs

1use rust_decimal::Decimal;
2use serde::Serialize;
3
4use crate::{
5    models::CryptoCurrencyCode,
6    utils::{serialize_comma_separated_list, serialize_decimal_to_string},
7};
8
9#[derive(Debug, Serialize)]
10pub struct GetTransfersParams {
11    /// Optional. Cryptocurrency alphabetic code. Supported assets: “USDT”, “TON”, “BTC”, “ETH”, “LTC”, “BNB”, “TRX” and “USDC” (and “JET” for testnet).
12    /// Defaults to all currencies.
13    #[serde(skip_serializing_if = "Option::is_none")]
14    pub(crate) asset: Option<CryptoCurrencyCode>,
15
16    /// Optional. List of transfer IDs separated by comma.
17    #[serde(
18        serialize_with = "serialize_comma_separated_list",
19        skip_serializing_if = "GetTransfersParams::should_skip_transfer_ids"
20    )]
21    pub(crate) transfer_ids: Option<Vec<u64>>,
22
23    /// Optional. Unique UTF-8 transfer string.
24    #[serde(skip_serializing_if = "Option::is_none")]
25    pub(crate) spend_id: Option<String>,
26
27    /// Optional. Offset needed to return a specific subset of transfers.
28    /// Defaults to 0.
29    #[serde(skip_serializing_if = "Option::is_none")]
30    pub(crate) offset: Option<u32>,
31
32    /// Optional. Number of transfers to be returned.
33    /// Values between 1-1000 are accepted.
34    /// Defaults to 100.
35    #[serde(skip_serializing_if = "Option::is_none")]
36    pub(crate) count: Option<u16>,
37}
38
39impl GetTransfersParams {
40    fn should_skip_transfer_ids(ids: &Option<Vec<u64>>) -> bool {
41        !matches!(ids, Some(ids) if !ids.is_empty())
42    }
43    pub(crate) fn new(
44        asset: Option<CryptoCurrencyCode>,
45        transfer_ids: Option<Vec<u64>>,
46        spend_id: Option<String>,
47        offset: Option<u32>,
48        count: Option<u16>,
49    ) -> Self {
50        Self {
51            asset,
52            transfer_ids,
53            spend_id,
54            offset,
55            count,
56        }
57    }
58}
59
60#[derive(Debug, Serialize)]
61pub struct TransferParams {
62    /// User ID in Telegram. User must have previously used @CryptoBot (@CryptoTestnetBot for testnet).
63    pub(crate) user_id: u64,
64
65    /// Cryptocurrency alphabetic code. Supported assets: “USDT”, “TON”, “BTC”, “ETH”, “LTC”, “BNB”, “TRX” and “USDC” (and “JET” for testnet).
66    pub(crate) asset: CryptoCurrencyCode,
67
68    /// Amount of the transfer in float.
69    /// The minimum and maximum amount limits for each of the supported assets roughly correspond to 1-25000 USD.
70    /// Use getExchangeRates to convert amounts. For example: 125.50
71    #[serde(serialize_with = "serialize_decimal_to_string")]
72    pub(crate) amount: Decimal,
73
74    /// Random UTF-8 string unique per transfer for idempotent requests.
75    /// The same spend_id can be accepted only once from your app.
76    /// Up to 64 symbols.
77    pub(crate) spend_id: String,
78
79    /// Optional. Comment for the transfer.
80    /// Users will see this comment in the notification about the transfer.
81    /// Up to 1024 symbols.
82    #[serde(skip_serializing_if = "Option::is_none")]
83    pub(crate) comment: Option<String>,
84
85    /// Optional. Pass true to not send to the user the notification about the transfer.
86    /// Defaults to false.
87    #[serde(skip_serializing_if = "Option::is_none")]
88    pub(crate) disable_send_notification: Option<bool>,
89}
crypto_pay_api/models/transfer/params.rs

crypto_pay_api/models/transfer/
params.rs
