開放 API 接入前準備

使用自己的 API Key

在開發者頁面申請或創建所需權限的 Key，設置必要的出口和限額。不要把 Key 寫入公開網頁或分享給第三方；子帳號還需有主帳戶授予的對應權限。

保持請求可追溯

按具體接口文檔提供冪等鍵，並保存請求標識和訂單 ID。相同業務重試沿用同一個冪等鍵；遇到超時先查已有訂單。完整路徑、參數與返回碼請登錄後閱讀當前開放 API 文檔。

準備接入權限

先登錄開發者頁面，使用自己帳號獲准的能力。

1. 查看對應 API 功能是否已開通；子帳號同時檢查主帳號授予的權限。
2. 創建所需權限的 Key，按業務配置出口 IP 和資金或操作限制。
3. 在服務器端安全保存憑據，不寫入公開網頁。
4. 打開當前開發者文檔，核對準確路徑、鑒權、參數與錯誤碼。

手冊截圖只展示入口位置，不包含可用的 API Key。

建議的最小接入順序

先做好結果查詢和冪等，再連接寫入操作。

1. 用只讀接口驗證鑒權與出口限制。
2. 為同一個業務請求保存固定冪等鍵。
3. 提交後記錄請求標識與平台訂單號。
4. 用查詢接口確認訂單狀態，再處理回調和售後邏輯。

接口失敗怎樣排查

依次檢查 HTTP 狀態、業務錯誤碼、權限、限額和冪等鍵。網絡超時不等於訂單失敗；先查詢已有訂單，再決定是否重試。向客服提供脫敏請求、請求標識、時間和錯誤碼，不提交密鑰或完整卡資料。