PayStablecoin 商戶 API - 集成指南

概述

PayStablecoin 商戶 API 使用 HMAC-SHA256 簽名認證來確保請求的安全性和完整性。本指南介紹如何使用 Postman、Java 或 Python 集成我們的 API。

環境

環境	API Base URL	商戶後台
沙箱	https://api.sandbox.paystablecoin.global	https://merchant.sandbox.paystablecoin.global
正式環境	https://api.paystablecoin.global	https://merchant.paystablecoin.global

開發和測試請使用沙箱環境，準備上線時再切換至正式環境。

---

前置條件

在開始整合 PayStablecoin 商戶 API 之前，請確保您已完成以下步驟：

1. 商戶帳戶註冊

• 在商戶後台（沙箱或正式環境）註冊商戶帳戶
• 完成任何必要的驗證流程

2. 保存您的 Merchant ID

• 在註冊過程中，您將獲得一個 Merchant ID（例如：1000）
• 請立即保存此值 - 所有 API 請求都需要它
• 如果遺失，請聯繫業務支援來恢復

3. 獲取您的 API 憑證

登入商戶後台後：

1. 在導航欄中找到 API Settings（API 設定）
2. 複製並安全存儲您的憑證：
   • API Key（例如：PSTG6ELOB2YXKO4ZHRQ6NKTSBY）
   • API Secret（例如：MpkvVlXvYTZVPPJ0LReNA-g_yC7V7foe4UAj7tgWJSM）

安全提醒

• 切勿將 API Secret 提交到版本控制系統
• 將憑證存儲在環境變數或安全保管庫中
• 如果憑證洩露，請立即聯繫支援

4. 準備您的整合環境

• 確保您的服務器時鐘已同步（建議使用 NTP）
• 準備 HTTPS 端點用於 Webhook（如果使用回調）
• 準備好測試交易流程

準備好了嗎？ 繼續閱讀下方的快速開始指南。

---

快速開始

下載 SDK 示例

獲取 Java 和 Python 的現成代碼示例：

📦 下載 SDK 示例（ZIP 壓縮包）

該包包含：

• Java - 完整 StablePayClient 實現的 Maven 項目
• Python - 可通過 pip 安裝的 SDK 和示例

下載後，解壓縮並按照每個語言文件夾中的 README 操作。

整合步驟

1. 閱讀 認證請求頭 了解如何設置請求頭
2. 學習 簽名算法 掌握簽名計算方法
3. 查看 重要注意事項 避免常見錯誤
4. 選擇適合您的集成方式：
   • Postman 整合 - 快速 API 測試
   • Java 整合 - Java 應用程序整合
   • Python 整合 - Python 應用程序整合

下一步

• 查看 API 參考 了解所有可用端點
• 設置 Webhook 通知 接收實時支付更新
• 閱讀 錯誤碼與解決方案 了解響應碼和故障排除
• 遵循 安全最佳實踐 確保安全整合

語言選擇

• English - 英文文檔
• 繁體中文 - 繁體中文文檔（當前）