# 測試 (環境/網路) 指南

## <mark style="color:blue;">簡介</mark>

歡迎來到 AkashicPay 測試指南！本指南將帶領您在部署到主網絡之前，在一個安全的測試環境中測試AkashicPay 的功能。測試網路允許開發人員和用戶在沒有真實加密資產風險的情況下實驗交易、智能合約和其他功能。

## <mark style="color:blue;">什麼是 AkashicPay 測試環境？</mark>

AkashicPay 測試環境是一個模擬主網路的測試環境，但使用的是測試貨幣和測試環境，而不是真正的加密貨幣。它的設計對象為：

* **開發人員**測試整合。
* **用戶**熟悉 AkashicPay 的功能。

### <mark style="color:blue;">先決條件</mark>

在您開始之前，請確定您已經：

* **訪問** **AkashicPay 測試環境儀表板**
  1. 如果您還沒有安裝 [AkashicLink（測試環境）](https://chromewebstore.google.com/detail/akashiclink-testnet/cbjaeakegfefnhommfnkglbfdgjlehpj)，請安裝 AkashicLink。
  2. 訪問 [testnet.akashicpay.com](https://testnet.akashicpay.com)，並使用您的 AkashicLink（測試環境）登錄。
  3. 完成上線程序，以進入測試環境。
* **生成您的 API/SDK 密鑰對**
  1. 導覽儀表板中的**密鑰對設置**。
  2. 按一下 「**產生密鑰對**」 以建立您的 API/SDK 密鑰對。
  3. 安全地儲存您的 API/SDK 密鑰對 - 整合時需要它們。
* **設定回調 URL (Webhook 設定)**
  1. 進入**回調設置**頁面。
  2. 輸入您應發送交易通知（例如，存款確認）的**回調 URL** 。
  3. 儲存設定，以確保測試期間即時更新。

### <mark style="color:blue;">下一步</mark>

在以下各節中，我們將介紹：

* 建立測試存款地址。
* 執行測試交易。
* 在第三方錢包上找到測試環境。
* 測試幣龍頭。

## <mark style="color:blue;">測試</mark>

### <mark style="color:blue;">在測試環境上測試 AkashicPay： 逐步指南</mark>

1. **建立一個測試存款地址**
   1. 請參考 AkashicPay [SDK](https://docs.akashicpay.com/traditional-chinese/sdk/sdk-ru-men#ce-shi) 或 [SecureAPI](https://docs.akashicpay.com/traditional-chinese/secureapi/secureapi-ru-men) 文件來建立一個測試環境。
   2. 用 SDK 或 SecureAPI 在以下任一網路上生成一個存款地址
      1. **Tron 波場 (Shasta 測試網路)**
      2. **Ethereum 以太坊 (Sepolia 測試網路)**
      3. **BNB Smart Chain Testnet 幣安智能測試鏈 (幣安測試網路)**
      4. **Solana 索拉拉 (Solana Devnet 測試網路)**
   3. 這可以模擬正式環境中終端用戶的存款地址。
2. **發送測試交易**
   1. 使用載有測試網路代幣的**相容錢包** (例如，Sepolia 和 BNB Smart Chain Testnet 幣安智能測試鏈的 MetaMask、Shasta 的 TronLink、Solana 的 Phantom 等)，向您產生的測試網路存款地址發送小額轉帳。
      1. 檢視交易：
         1. 檢查 **AkashicScan** 測試環境[區塊瀏覽器](https://testnet.akashicscan.com)。
         2. 確認**回調 URL** 收到確認。
         3. 確認存款反映在您的 AkashicPay 測試環境儀表板上。

## <mark style="color:blue;">第三方錢包上的測試網路在哪裡？</mark>

### <mark style="color:blue;">Tron-SHASTA (波場)</mark>

打開相容的錢包並瀏覽測試網路：

* 使用第三方錢包，如 **TronLink**（用於 Tron Shasta 測試網路）。
* 按照以下截圖確保您連線到正確的測試網路。
* 如果您已經向 TronLink 生成的 Tron 地址[申請了測試幣](#ce-shi-bi-long-tou)，則在切換到測試網路之後，測試幣就會出現在這裡。

#### <mark style="color:blue;">桌面 Chrome 瀏覽器應用程式</mark>

| 開啟您的 TronLink，並選擇標頭的下拉式 ->                                                                                                                                                                                                                                                                | 選擇 TRON Shasta 測試網路                                                                                                                                                                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FdHPiMmm7w2eryfFqJkzN%2Fimage.png?alt=media&#x26;token=421739e1-f857-4608-af4d-2e2d011f978f" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FxHDxC9NvQdqUOz2AvTzS%2Fimage.png?alt=media&#x26;token=1162d82b-5f40-4163-a85b-f344320829ff" alt=""><figcaption></figcaption></figure></div> |

#### <mark style="color:blue;">將 USDT 測試幣代幣地址加入您的 TronLink</mark>

導覽到 USDT (Tron-SHASTA) 合約地址 TronScan Shasta 測試網路上的 [TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs](https://shasta.tronscan.org/#/token20/TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs)。點擊下面截圖中的按鈕，用您的 TronLink 進行授權，將 USDT 測試幣添加到您的 TronLink 上。

<figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FoZ2XgaezSqEOy9KULF3g%2Fimage.png?alt=media&#x26;token=e8114b93-15f8-4141-9244-03ac1caf20d1" alt=""><figcaption></figcaption></figure>

| 測試代幣 | 代幣合約地址                                                                                                         |
| ---- | -------------------------------------------------------------------------------------------------------------- |
| USDT | [TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs](https://shasta.tronscan.org/#/token20/TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs) |

***

### <mark style="color:blue;">Ethereum-SEPOLIA (以太坊)</mark>

開啟相容的錢包並瀏覽測試網路：

* 使用 MetaMask 等第三方錢包（用於 Ethereum Sepolia 測試網路）。
* 按照下面的截圖確保您連線到正確的測試網路。
* 您可以直接向我們索取測試幣。如果您之前已經有，在您切換到測試網路並添加代幣地址後，它們就會出現在這裡。

#### <mark style="color:blue;">桌面 Chrome 瀏覽器應用程式</mark>

| 開啟您的 MetaMask，並在子群組「代幣」下方選擇下拉選單 ->                                                                                                                                                                                                                                                                    | 選擇 Custom ->                                                                                                                                                                                                                                                                                          | 選擇 Sepolia                                                                                                                                                                                                                                                                                            |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FFuqLzIjYcGfDdq0gSJj2%2Fimage.png?alt=media&#x26;token=e623fe23-6b61-4671-8338-1e912afdfdb0" alt="" width="373"><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2F56zkTm9oAEJvFHchuObY%2Fimage.png?alt=media&#x26;token=4af3d9f7-32cf-4a2c-9821-143f0d97b459" alt="" width="373"><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2Ffkool8Mh3DoGu9lmHQSy%2Fimage.png?alt=media&#x26;token=41692550-3aed-4da7-a662-9c7564775971" alt="" width="370"><figcaption></figcaption></figure></div> |

#### <mark style="color:blue;">將測試代幣地址加入您的 MetaMask</mark>

請導航至您的 MetaMask 並切換至 Sepolia 測試網路。從下方表格匯入資料。請參照截圖步驟，將測試幣添加至您的 MetaMask 錢包。

| 找到並按一下錢包中的 「⋮」 ->                                                                                                                                                                                                                                                                         | 按 「+ Import Tokens」 ->                                                                                                                                                                                                                                                                    | 選擇 Sepolia 並輸入代幣合約地址                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2Fs0VGoYGRpQMrXmIlaEqc%2Fimage.png?alt=media&#x26;token=63818d9d-5528-4b0a-b783-3cdf6f43d275" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FExQ00w8fav4XOGY1yPKR%2Fimage.png?alt=media&#x26;token=92ff8403-05cb-4a4c-be2f-68444cbdc357" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FLKCAJSAJnh2l9yQf370E%2Fimage.png?alt=media&#x26;token=2509bf03-8985-43d6-a23c-828e3a65f44e" alt=""><figcaption></figcaption></figure></div> |

| 測試代幣   | 代幣合約地址                                                                                                                        |
| ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| APUSDT | [0xA62bE7Ec09f56A813f654A9AC1aa6d29D96F604e](https://sepolia.etherscan.io/token/0xa62be7ec09f56a813f654a9ac1aa6d29d96f604e)   |
| APUSDC | [0x92Ac12b566954E3d0E966ccA7c9ddc44Ca80AE29](https://sepolia.etherscan.io/address/0x92Ac12b566954E3d0E966ccA7c9ddc44Ca80AE29) |

***

### <mark style="color:blue;">**BNB Smart Chain Testnet (幣安智能測試鏈)**</mark>

開啟相容的錢包並瀏覽測試網路：

* 使用 MetaMask 等第三方錢包（用於 BNB Smart Chain Testnet 幣安智能測試鏈 (幣安測試網路)）。
* 輸入正確的網路資訊和以下截圖，以確保連線至正確的測試網路。
* 您可以直接向我們索取測試幣。如果您之前已經有，在您切換到測試網路並添加代幣地址後，它們就會出現在這裡。

#### <mark style="color:blue;">網路詳細資料</mark>

* 網路名稱：BNB Smart Chain Testnet&#x20;
* 預設 RPC URL：`https://data-seed-prebsc-1-s1.bnbchain.org:8545`&#x20;
* 鏈 ID：97
* 貨幣代碼：tBNB
* 區塊鏈瀏覽器：`https://testnet.bscscan.com`

| 導覽到 「Enabled networks」 ->                                                                                                                                                                                                                                                                             | 按 「+ Add custom network」 ->                                                                                                                                                                                                                                                                                  | 輸入自訂網路詳細資訊                                                                                                                                                                                                                                                                                            |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FlMw3CkdGZpyjMMUDjVTw%2Fimage.png?alt=media&#x26;token=8dcb851d-0278-4d11-8696-5271b8d7e07e" alt="" width="373"><figcaption></figcaption></figure></div> | <p></p><div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FCgHmSY0hb6Ldq6EgpgYX%2Fimage.png?alt=media&#x26;token=c7ccd686-6f14-46d9-9161-0613e48cdb0a" alt="" width="371"><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2Ft2Xy0tn65GU9O2ZltFBR%2Fimage.png?alt=media&#x26;token=d466ffbc-44eb-49fc-ab9c-06014fb87223" alt="" width="375"><figcaption></figcaption></figure></div> |

#### <mark style="color:blue;">將測試代幣地址加入您的 MetaMask</mark>

導覽到您的 MetaMask 至幣安智能測試鏈（BNB Smart Chain Testnet）測試網路。從下方表格匯入資料。請參照截圖步驟，將測試幣添加至您的 MetaMask 錢包。

| 找到並按一下錢包中的 「⋮」 ->                                                                                                                                                                                                                                                                                     | 按 「+ Import Tokens」 ->                                                                                                                                                                                                                                                                                | 選擇 BNB Smart Chain Testnet                                                                                                                                                                                                                                                                            |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2Fkjw5o8B9iTiB9JIhuoUB%2Fimage.png?alt=media&#x26;token=bc527109-df49-4fdf-bff1-499cfb2b6260" alt="" width="376"><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FeQnRoZBKPpqlP8RTUVm2%2Fimage.png?alt=media&#x26;token=08e923f0-fc6f-45e8-83e8-913eabdfc4ad" alt="" width="372"><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2Fe0OKkKcCaw0jw44B5c6p%2Fimage.png?alt=media&#x26;token=712336cd-0cc8-4438-ba1e-8e7098f663bd" alt="" width="379"><figcaption></figcaption></figure></div> |

| 測試代幣   | 代幣合約地址                                                                                                                       |
| ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| USDT   | [0xA62bE7Ec09f56A813f654A9AC1aa6d29D96F604e](https://testnet.bscscan.com/token/0xa62be7ec09f56a813f654a9ac1aa6d29d96f604e)   |
| APUSDC | [0x9114Eb6B5d281AE405C23082CF56043daC280cbA](https://testnet.bscscan.com/address/0x9114Eb6B5d281AE405C23082CF56043daC280cbA) |

***

### <mark style="color:blue;">Solana Devnet (索拉拉)</mark>

開啟相容錢包並導航至測試網：

* 請使用第三方錢包（例如 Phantom 適用於 Solana Devnet 開發網）。
* 請透過選擇正確設定及參照下方截圖，確保已連接至正確的開發網 (Devnet)。
* 您可直接向我們申請測試幣。若先前已申請過，切換至測試網並新增代幣地址後，這些測試幣將顯示於此處。

| 導航至左上角的圖示 ->                                                                                                                                                                                                                                                                                          | 選擇 「Settings」→                                                                                                                                                                                                                                                                                        | 在搜尋欄輸入 「Developer」→                                                                                                                                                                                                                                                                       | 開啟 「Testnet Mode」                                                                                                                                                                                                                                                                                                                            |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FOZCCtkDWEYVEU0ST8NOJ%2Fimage.png?alt=media&#x26;token=1d3fe9f5-ae13-4012-be57-57281a000b45" alt="" width="335"><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FNeGfCzPSTm4dZJNsb4YS%2Fimage.png?alt=media&#x26;token=6a2f4627-6437-4d3e-baf9-e2f6b7a5cfd7" alt="" width="338"><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FglHUy2azp0bBVPqdFF3v%2Fimage.png?alt=media&#x26;token=049a74d0-63f0-4f9c-8ecb-92a66b6201a3" alt=""><figcaption></figcaption></figure></div> | <div><figure><img src="https://812529792-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTlygtL7GMdsE7h1Lavf%2Fuploads%2FHR7x8w5Wvsmf1u7smhMb%2Fimage.png?alt=media&#x26;token=a08919f5-3cda-442a-aa1c-56bbd181c792" alt="" width="336"><figcaption><p>\*請確保您正在使用 Solana 開發網絡 (Devnet)！</p></figcaption></figure></div> |

| 測試代幣   | 代幣合約地址                                                                                                                               |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| APUSDT | [6krZNyyrvgN1XdvLVZwoAY4UvZxgiYVLtJwLYt43GHym](https://solscan.io/token/6krZNyyrvgN1XdvLVZwoAY4UvZxgiYVLtJwLYt43GHym?cluster=devnet) |
| APUSDC | [7gZkdXQcNzfw4eDJvgN4XuPxBnsf2AyRnjga4XQ7ber8](https://solscan.io/token/7gZkdXQcNzfw4eDJvgN4XuPxBnsf2AyRnjga4XQ7ber8?cluster=devnet) |

## <mark style="color:blue;">測試幣龍頭</mark>

#### <mark style="color:blue;">Tron-SHASTA 測試幣</mark>

在測試和本地開發期間，您需要在測試網路上使用加密貨幣才能做任何有意義的事情。如果您需要測試幣，官方 [Tron Discord](https://discord.com/invite/nSBF64yb5U) 或 [Tron Telegram](https://t.me/TronOfficialDevelopersGroupEn) 會每 24 小時在 Shasta 上提供使用者 5000 TRX 或 USDT。

**Discord** 方面：

* 只需在伺服器中驗證您的 Discord 帳號，前往 [#faucet-test-coins](https://discord.com/channels/491685925227724801/999575963920781382) 頻道。
* 輸入 <mark style="color:yellow;">!shasta \[L1 TRON 地址]</mark> 或 <mark style="color:yellow;">!shasta\_usdt \[L1 TRON 地址]</mark>

  > 範例： !shasta\_usdt TGajNwE1LPrbaGdtHs3mN29bTVdQrcz8ep

  * 並傳送至頻道以接收您的測試幣。

***

**Telegram** 方面：

* 只需輸入 <mark style="color:yellow;">!shasta \[L1 TRON 地址]</mark> 或 <mark style="color:yellow;">!shasta\_usdt \[L1 TRON 地址]</mark>

  > 例如： !shasta\_usdt TGajNwE1LPrbaGdtHs3mN29bTVdQrcz8ep

  * 並將其發送至頻道以接收您的測試幣。

#### <mark style="color:blue;">Ethereum-SEPOLIA 測試幣</mark>

請與我們聯絡，並傳送您的以太坊 (Ethereum) 地址給我們，以索取測試幣。

#### <mark style="color:blue;">**BNB Smart Chain Testnet (幣安智能測試鏈) 測試幣**</mark>

請聯繫我們並發送您的幣安智能鏈 (BNB Smart Chain (BSC)) 地址給我們以申請測試幣。如果您使用 MetaMask，該地址應與您的以太坊 (Ethereum) 地址相同。

#### <mark style="color:blue;">Solana Devnet</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**測試幣**</mark>

請聯絡我們並提供您的索拉拉 (Solana) 地址，以申請測試幣。