建立整合

6MM Agent SDK

以 Markdown 格式查看

6MM Agent SDK 是針對需要呼叫特權代理API，卻無法從零實作簽署與請求處理的合作夥伴後端服務。該服務不得在瀏覽器、行動裝置或公共桌面程式碼中執行，因為整合使用合作夥伴API 秘密。

何時使用 Agent SDK

當你的後端需要綁定合作夥伴使用者、透過核准的工作流程移動資產、查詢交易紀錄、建立嵌入的交易條目URL，或驗證 webhook 通知時，可以使用 Agent SDK。使用 Trading Widget SDK 當合作夥伴前端需要顯示交易介面時，則會另外處理。

能力

劇本Java SDKPHP SDK
綁定使用者支援支援
固定金額轉移支援支援
全部轉交支援支援
反向轉移支援支援
查詢順序支援支援
建立入口 URL支援支援
Webhook 驗證支援支援

常見配置

說明範例描述
baseUrlhttps://agent-api.6mm.com6MM 代理人 API 服務 URL ，沒有尾部斜線。
agentCodeAGENT001夥伴特工代碼。
apiSecret你的 API 秘密API 簽署秘密只會儲存在後端。
defaultCurrencyUSDT轉帳和帳戶的預設貨幣 API。
webhookUrlhttps://partner.example.com/6mm/webhook合作夥伴端點用於 6MM webhook 通知。

典型積分流程

  1. 合作夥伴前端透過合作夥伴自己的帳號系統驗證使用者。
  2. 合作夥伴後端將使用者映射到穩定的合作夥伴端識別碼。
  3. 後端呼叫 Agent SDK ， agentCode 且受保護的 API 秘密。
  4. SDK 簽署並向代理人發送 API 請求。
  5. 後端儲存回傳的商業識別碼，並以冪等方式處理後續的 webhooks。
  6. 前端僅接收其所需的短暫結果或進入憑證。

選擇一個 SDK

後端堆疊從這裡開始
JavaJava SDK 概述 以及 Java 快速入門
PHPPHP SDK 概述 以及 PHP 快速入門

製作檢查清單

  • 從後端秘密管理器載入 apiSecret ，而非原始碼。
  • 將開發、舞台設計與製作資格分開。
  • 使用穩定的合作夥伴使用者映射及獨特的商業訂單識別碼。
  • 在檢查逾時請求狀態時保留原始識別碼。
  • 驗證 webhook 簽名並儲存處理中的事件 ID。
  • 從日誌中刪除秘密與簽章，同時保留請求 ID 以供支援。

下一步

Java 快速入門

在Java後端安裝並初始化Agent SDK。

PHP 快速入門

在PHP後端安裝並初始化Agent SDK。

Webhook 與冪等性

確認回電並避免重複的業務處理。