# 錯誤處理

AkashicPay SDK 可能會丟出或回傳錯誤 (擴充語言的預設錯誤物件)，並帶有特定的錯誤代碼。對於 `/payout` 端點，錯誤通常是回傳而不是拋出。以下是 Akashic 特有的錯誤、解釋和建議的行動。

| 錯誤代碼                          | 說明                                 | 該怎麼做                                                                                       |
| ----------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------ |
| OTK\_ONBOARDING\_FAILED       | 在 AkashicChain 上設定 OTK 進行測試失敗。     | 再試一次。如果問題仍然存在，請聯絡 [AkashicPay 客服中心](https://t.me/akashicpay_support_bot)。                  |
| INVALID\_PRIVATE\_KEY\_FORMAT | 用於實體化 SDK 的密鑰對或恢復原密語無效。            | 再次檢查您的變數，然後再試一次。                                                                           |
| WALLET\_CREATION\_FAILURE     | 在 AkashicChain 上建立 L1 錢包失敗。        | 再試一次。如果問題仍然存在，請聯絡 [AkashicPay 客服中心](https://t.me/akashicpay_support_bot)。                  |
| UNHEALTHY\_WALLET             | 在 AkashicChain 上建立了一個錢包，但無法驗證是否安全。 | 再試一次。如果問題仍然存在，請聯絡 [AkashicPay 客服中心](https://t.me/akashicpay_support_bot)。                  |
| ACCESS\_DENIED                | 嘗試在生產環境中存取 OTK（不允許）。               | 請勿在正式環境中嘗試這樣做。                                                                             |
| L2ADDRESS\_NOT\_FOUND         | 格式錯誤或第 2 層交易的 L2 地址不存在。            | 再次檢查您的輸入並再次嘗試。                                                                             |
| NOT\_SIGNED\_UP               | 未在 AkashicPay.com 上完成設定即實作 SDK。    | 在 AkashicPay.com 上完成設定，然後再試一次。                                                             |
| FUNDS\_EXCEEDED               | 嘗試提取的資金超過可用資金。                     | 檢查您的餘額和輸入，然後再試一次。                                                                          |
| ASSIGNMENT\_FAILED            | 在 AkashicChain 上建立 L1 錢包失敗。        | 再試一次。如果問題仍然存在，請聯絡 [AkashicPay 客服中心](https://t.me/akashicpay_support_bot)。                  |
| INVALID\_PARAMETER            | 提供給函數的參數無效（僅 Java 及 C#）。           | 仔細檢查您的輸入是否有語法錯誤。                                                                           |
| UNKNOWN\_ERROR                | 發生未指定的錯誤。                          | 檢查錯誤訊息的詳細資訊。稍作延遲後重新嘗試。如果問題仍然存在，請聯絡 [AkashicPay 客服中心](https://t.me/akashicpay_support_bot)。 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akashicpay.com/traditional-chinese/secureapi/cuo-wu-chu-li.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
