Skip to main content
在你的應用專案中，將以下指令交給 Codex、Claude Code 等程式開發 Agent：
官方 Prompt、任務索引和驗證清單皆為公開 Markdown，閱讀無需登入。也可以在商戶控制台的 開發者工具 > API Keys 複製串接指令。

​
選擇串接方式

實際可用付款方式、金額和幣別取決於商戶已開通的渠道。新訂閱銷售目前暫停，本指引涵蓋一次性收款。

​
準備帳戶與憑證

註冊或登入商戶帳戶，確認開戶、渠道等前提條件，並在開發者設定取得憑證。註冊、認證、協議接受和付款由你完成；Agent 可以準備程式並引導後續步驟。 在應用的服務端環境變數或密鑰管理器中私下設定密鑰，不要貼到 Agent 對話或提交到版本庫。原生 Webhook Secret 與 API Key 不同。原生串接應在首筆付款前設定 Webhook，事後設定不會自動產生過去的 order.paid 通知。 目前沒有自助 Sandbox 密鑰。只有 Kyren 提供對應位址和憑證後，才使用 Staging 環境。不要在未經確認的生產渠道使用測試卡。

​
檢查串接結果

讓 Agent 列明修改檔案、執行本地測試並報告待處理事項。重點檢查簽名拒絕、重複通知防重、金額與幣別關聯及故障恢復。應用不能根據瀏覽器返回判斷付款成功。 本地模擬測試不代表真實付款已通過。取得授權測試環境後，由你完成付款，再分別核對 Kyren 已付款訂單和應用履約紀錄。生產驗收前閱讀上線清單；尚未執行的環節應由 Agent 明確標記為未驗證。