# 要求金額和貨幣 (Requested amount & currency)

[`getDepositAddress`](https://docs.akashicpay.com/traditional-chinese/sdk/han-shi-functions/getdepositaddress)或 [`getDepositUrl`](https://docs.akashicpay.com/traditional-chinese/sdk/han-shi-functions/getdepositurl) 時，您可以額外指定您希望收到的金額（在一個貨幣範圍內）。如果在 AkashicPay 的開發者設置中啟用了金額匹配，`referenceId` 只會被附加到與要求的金額匹配的存款的回調中。

***

## <mark style="color:blue;">重要事項</mark>

* 放寬配對可以在[開發者](https://docs.akashicpay.com/traditional-chinese/yi-biao-ban/kai-fa-zhe#fang-kuan-pei-dui)中設定。
* 請求金額與實際存款金額之間的匹配誤差範圍為 ±1%。
* 如果指定的貨幣與存款貨幣不同，則採用請求地址/網址時的匯率（尤其與法幣金額相關）。
* 無論是否匹配，所有存款（如果回調 URL 已正確配置）仍會發送回調。不同之處在於包含 `referenceId` 和 `depositRequest` 欄位
  * `depositRequest` 將包含 `exchangeRate` 和 `requestedValue`（詳情請參閱存款回調）。

> 注意：我們提供放寬配對功能，以處理要求的存款金額和實際存款金額之間的差異 - [在此](https://docs.akashicpay.com/traditional-chinese/yi-biao-ban/kai-fa-zhe#song-chi-pei-dui)瞭解更多資訊。

## <mark style="color:blue;">加價 / 減價</mark>

AkashicPay 提供了一個機制，讓您可以輕鬆地為入金加上加價（Markup）或減價（Markdown）。透過在 [`getDepositAddress`](https://docs.akashicpay.com/traditional-chinese/sdk/han-shi-functions/getdepositaddress) 或 [`getDepositUrl`](https://docs.akashicpay.com/traditional-chinese/sdk/han-shi-functions/getdepositurl)中提供額外參數，系統會根據您設定的比例調整所請求幣種與實際收款幣種之間的匯率。

$$
R\_f = R\_i \times  \dfrac{100 + X}{100}
\\
\--------------------------\\
R\_i = \text{Initial Rate}, R\_f = \text{Final Rate}, X =\text{Markup/markdown percentage}
$$

若參數 X 為正數，則為加價／溢價；若為負數，則為減價／折扣。X 的範圍限制為 `(-100,100)`

&#x20;\
例子：

您希望入金等值 100 港元，付款幣種為 USDT。假設港元兌 USDT 匯率為 0.12（即 1 港元值 0.12 USDT），正常情況下，您需要支付 12 USDT。

然而，若設定加價為 10%，則匯率會由 0.12 調整為 0.132，意味著該筆交易需要在收到 13.2 USDT 後才會完成。

## <mark style="color:blue;">支援貨幣</mark>

#### &#xD;您可以要求以下列法定貨幣支付金額：

* CNY (人民幣/中華人民共和國元)
* HKD（港幣）
* TWD（新台幣）
* USD（美元）
* CHF（瑞士法郎）
* EUR（歐元）
* IDR（印尼盾）
* INR（印度盧比）
* JPY（日圓）
* KHR（柬埔寨幣）
* KRW（韓圜）
* MYR（馬來西亞幣）
* PHP（菲律賓比索）
* SGD（新加坡幣）
* THB（泰銖）
* VND（越南盾）

以及下列加密貨幣：

* TRX (波場)
* ETH (以太坊)
* BNB (幣安智能鏈 (BNB Smart Chain (BSC)))
* SOL (索拉拉)
* USDT (TRX)
* USDT (ETH)
* USDC (ETH)
* USDT (BNB)
* USDC (BNB)
* USDT (SOL)
* USDC (SOL)

存款可以任何一種支援的加密貨幣結算：

* TRX (波場)
* ETH (以太坊)
* BNB (幣安智能鏈 (BNB Smart Chain (BSC)))
* SOL (索拉拉)
* USDT (TRX)
* USDT (ETH)
* USDC (ETH)
* USDT (BNB)
* USDC (BNB)
* USDT (SOL)
* USDC (SOL)

## <mark style="color:blue;">範例</mark>

注意：本頁面的代碼應視為*偽碼* (*pseudocode)*。有關每種支援語言的詳細資訊，請參閱說明文件中描述特定功能的頁面。

假設您希望用戶 `user1` 存入等值於 10 元人民幣的資金，並且希望用戶使用波場網路（Tron Network）。 首先，您會要求一個存款地址，就像這樣：

```
AkashicPay.getDepositAddressWithRequestedValue('TRX', 'user1', 'order-123', 'CNY', '10.00')
```

作為回報，您將得到一個地址提供給用戶。您可以通知他們向該地址存入相當於 10 元人民幣的加密貨幣。

在提出此要求時，試想 1 TRX 恰好值 2 人民幣。如果用戶隨後存入 5 TRX，訂單將得到滿足，回調將包括以下額外字段（完整的回調詳情請參閱存款回調）：

```json
{
...,
"referenceId": "order-123",
"depositRequest": {
    "exchangeRate": "2.00"
    "requestedValue": {
        "amount": "10.00",
        "currency": "CNY"
        },
    },
...
}
```

但是，如果用戶存入例如 10 TRX，訂單就不會被滿足，上述欄位也不會包含在回調中 (雖然回調仍會傳送!)。只有在完全匹配的情況下，訂單才會被滿足，回調才會被填入。

> &#x20;注意：存款請求預設在1天（24小時）後失效！
>
> * 超過 24 小時後，用戶仍可進行存款且您仍會收到款項，但參考 ID (`referenceId`) 將失效且不會進行金額匹配。
> * 您可在回調設置中調整此到期時間，範圍為 00:15 至 24:00 小時。