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

getDepositAddress或 getDepositUrl 時，您可以額外指定您希望收到的金額（在一個貨幣範圍內）。如果在 AkashicPay 的開發者設置中啟用了金額匹配，referenceId 只會被附加到與要求的金額匹配的存款的回調中。

---

重要事項

• 金額配對是可選的，可以在 Dashboard 的開發人員設定中設定。

  • 預設為啟用

• 金額會匹配到小數點後 2 位。

• 如果指定的貨幣與存款貨幣不同，則採用請求地址/網址時的匯率（尤其與法幣金額相關）。

• 無論是否匹配，所有存款（如果回調 URL 已正確配置）仍會發送回調。不同之處在於包含 referenceId 和 depositRequest 欄位

  • depositRequest 將包含 exchangeRate 和 requestedValue（詳情請參閱存款回調）。

支援貨幣

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

• CNY (人民幣/中華人民共和國元)

• HKD（港幣）

• TWD（新台幣）

• USD（美元）

以及下列加密貨幣：

• TRX (波場)

• ETH (以太坊)

• USDT (TRX)

• USDT (ETH)

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

• TRX (波場)

• ETH (以太坊)

• USDT (TRX)

• USDT (ETH)

範例

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

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

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

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

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

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

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

注意：存款要求在 1 天（24 小時）後過期！

• 24 小時後，用戶仍可存款，您仍會收到資金，但 referenceId 將會過期，且不會進行金額匹配。