# 開發者

## <mark style="color:blue;">概述</mark>

<figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FEhPlsgwqQ7xFCFKf2L0A%2Fimage.png?alt=media&#x26;token=2411844d-9a0d-4a78-bfe1-7c3f636623e9" alt=""><figcaption></figcaption></figure>

概述部分提供 API 使用統計資料的全面摘要。這包括總請求、成功率、平均回應時間和錯誤率等關鍵指標。此外，您還可以找到詳細的圖表，說明 API 使用趨勢和 HTTP 狀態碼分佈，以便進一步分析。

## <mark style="color:blue;">密鑰對設置</mark>

### <mark style="color:blue;">產生 API/SDK</mark> <mark style="color:blue;">密鑰對</mark>

<figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FH66cjrSXwqhX6qK3CpJZ%2FScreenshot%202025-07-20%20031903.png?alt=media&#x26;token=e794fdfc-9aed-48c4-914b-89bd9b128b5d" alt=""><figcaption></figcaption></figure>

API/SDK 密鑰對是與 AkashicPay SDK 或 SecureAPI 整合時所需的重要安全憑證：

* 當您第一次加入 AkashicPay 時，您應該已經生成了您的第一個 API/SDK 密鑰對。
* 這個 API/SDK 密鑰對用於驗證您與 AkashicPay SDK 或 SecureAPI 的整合。
* 刷新並接收一個全新的 API/SDK 密鑰對：
  1. 導航到 「密鑰對設置」 頁面。
  2. 點擊 「刷新密鑰對」 按鈕。
  3. 按提示確認操作。

> 重要： 同一時間只能有一個有效的 API/SDK 密鑰對。當您更新您的 API/SDK 密鑰對時，之前的 API/SDK 密鑰對會立即失效，無法使用。這意味著您需要在您的 AkashicPay SDK 或 SecureAPI 實作中更新 API/SDK 密鑰對憑證。

## <mark style="color:blue;">回調設置</mark>

<figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FMIH0zms5yEIb8qMc5zFe%2Fimage.png?alt=media&#x26;token=7a3f053f-e328-4b5e-b6a0-af7d522beb80" alt=""><figcaption></figcaption></figure>

### <mark style="color:blue;">API</mark> <mark style="color:blue;">驗證碼</mark>

這個 API 驗證碼是用來驗證您的網路勾選簽名的。AkashicPay 實現了一個強大的安全協議，用於回調驗證，以確保與[業務夥伴（BP）](https://docs.akashicpay.com/traditional-chinese/jian-jie/shu-yu#ye-wu-huo-ban-bp)的安全通信。當發送 HTTP 回調時，AkashicPay 會在標頭中包含一個使用API 驗證碼簽署的簽名，允許 BP 確認請求的真實性。BP 可以通過向 AkashicPay 發回已簽名的請求來進一步驗證回調，AkashicPay 隨後會回應另一個回調來確認驗證。這個多步驟流程與 IP 白名單相結合（BP 將 AkashicPay 的 IP 地址列入白名單），大大降低了未經授權的回調或來自不同 IP 範圍的攻擊的風險，防止了 BP 平台上的欺詐性自動充值，確保了交易環境的安全性。\
如需詳細資訊，請參閱[回調安全性](https://docs.akashicpay.com/traditional-chinese/hui-diao/hui-diao-an-quan-xing)頁面。

### <mark style="color:blue;">回調 URL 配置</mark>

AkashicPay 要求您提供特定的回調 URL，以確保您的系統和 AkashicPay 平台之間的溝通順暢有效。這些URL 對於接收有關交易狀態、更新和其他與您帳號相關的重要事件的通知至關重要。

正確配置這些回調 URL 對於 AkashicPay 服務的無縫操作是至關重要的，它可以確保您隨時了解情況，並有效地處理您的交易。

> **注意**：對於價值小於 1 USD 等值的代幣的第 1 層存款，不會發送存款回調。

AkashicPay 允許您設定下列 URL：

| 回調類型          | 用途              |
| ------------- | --------------- |
| 提款/提幣回調 URL   | 完成提款的通知         |
| 存款回調 URL      | 完成存款的通知         |
| 待提幣回調 URL     | 已註冊但未確定提款的最新資訊  |
| 待存款回調 URL     | 已註冊但未確定的存款的最新資訊 |
| 失敗提款/提幣回調 URL | 未成功提款嘗試的警示      |
| 失敗存款回調 URL    | 存款嘗試不成功的警示      |

> 我們目前支援下列貨幣的回調 URL： ETH、TRX、BNB、USDT (ETH)、USDC (ETH)、USDT (TRX) 、USDT  (BNB) 和 USDC (BNB)。

> **注意**：將任何回調 URL 留空表示您將不會收到該類事件的通知。對於關鍵作業，建議設定所有相關的回調。

### <mark style="color:blue;">附加功能</mark>

<figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2Fz6hCyMg1oRxE1IFuiRB5%2Fimage.png?alt=media&#x26;token=8f6ffe43-a105-40e7-8785-775e509e41d3" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">包含手動回調</mark>

啟用後，即使是在 SDK 或 SecureAPI 以外進行的交易，也會觸發存款和提幣回調。這將始終確保回調被執行到您的系統。

#### <mark style="color:blue;">放寬配對</mark>

終端客戶存款時，實際金額可能與要求的金額不同。因此，我們收到的回調可能不包含參考 ID `referenceId`，因為當金額未對齊時，我們的系統無法匹配金額（詳情請參閱[此處](https://docs.akashicpay.com/traditional-chinese/zhi-nan/yao-qiu-de-jinehe-huo-bi-requested-amount-currency#zhong-yao-shi-xiang)）。

此功能在要求的存款金額和實際存款金額之間引入了一個靈活的臨界值，因此最終客戶不再需要存入準確的要求值來接收 AkashicPay 和商業夥伴 (BP) 系統之間的回調。

預設臨界值設定為 **±1%**，但商業夥伴（BP）可以在 **±1% 到 20%** 之間任意調整。

> **範例**
>
> 如果終端客戶要求存入 500 USDT，但實際存入的是 499 USDT，放寬配對功能（預設為 ±1％）仍會匹配該筆存款。任何介於 495 USDT 和 505 USDT 之間的金額都會被接受，並與參考 ID (`referenceId`) 連結。

#### <mark style="color:blue;">存款請求有效期限</mark>

預設情況下，存款請求的到期時間設定為 24 小時。然而，在 AkashicPay 中，[商業夥伴（BP）](https://docs.akashicpay.com/traditional-chinese/jian-jie/shu-yu#ye-wu-huo-ban-bp)可靈活自訂此時限。到期時間可調整為 15 分鐘至 24 小時內的任意值，讓商業夥伴能定義最符合其業務需求與交易政策的時限框架。

> 注意：延長存款請求的到期時間意味著，在所選時間範圍內，終端客戶可進行存款操作，您將收到款項，且回調時將包含參考 ID (`referenceId`) 並執行金額比對。
>
> 超過所選時間範圍內後，終端客戶仍可進行存款且您仍會收到款項，但參考 ID (`referenceId`) 將失效且不會進行金額匹配。

## <mark style="color:blue;">最佳實務</mark>

* **記錄密鑰對變更**： 當更新您的輔助密鑰對時，請確保所有團隊成員都知道此變更，以避免整合問題。
* **儲存變更**：在 「附加功能」 中進行編輯後，請記得儲存。