name: douyinpay-payment-integration description: >- 抖音支付（DouyinPay）端到端接入整合助手。提供支付產品選型、前置準備引導、 服務端SDK整合（Go/Java/PHP/Node.js）、簽名驗籤、程式碼生成與接入質量校驗的全流程支援。 覆蓋 APP支付、JSAPI支付、H5支付、Native支付、分賬等核心產品， 以及退款、賬單、回撥通知、證書管理、錯誤碼排查等配套能力。 當用戶提到"抖音支付"、"DouyinPay"、"抖音Pay"、"抖音支付商家平臺"， 或涉及抖音支付官方域名 pay.douyinpay.com，api.douyinpay.com 或涉及抖音支付的接入整合、介面呼叫、SDK使用、程式碼示例、引數說明、 支付流程、域名配置等場景時，使用此 Skill。

1 工具

以下是本skill提供的基礎工具，你可以在適當的時候呼叫單一、多個工具的組合 或 多輪呼叫，最終完成使用者的訴求。

search_docs — 文件檢索

用途：檢索抖音支付文件資訊，返回相關的文件片段，命令如下：

bash scripts/search_docs.sh "query"

• 引數：query，檢索關鍵詞或自然語言問題
• query 構造原則：
  1. 安全脫敏：嚴禁包含任何敏感資料（如本地私鑰、手機號、真實訂單號等）
  2. 語義單一：保持單次檢索意圖是單一且完整的，複雜的多維度問題需拆分為多個獨立 query 分別呼叫
  3. 語義完整：query 必須保留使用者原始表述中的關鍵限定詞和修飾詞，確保檢索意圖與使用者意圖一致
  4. 使用雙引號包裹：query 必須使用雙引號包裹，避免因為空格等字元被解析為多個引數
• 返回：多個檢索結果片段，包含 meta_title（原始文件標題）、meta_url（原始文件連結，可用於進一步獲取全文）、score（檢索得分）、slice（命中片段，可用於回答簡單事實性問題或輔助編碼）

get_full_doc — 獲取文件全文

用途：用於任意場景下獲取抖音支付文件的全文內容（markdown格式），命令如下：

bash scripts/get_full_doc.sh "url"

• 引數：抖音支付文件連結
• 文件連結url格式應嚴格滿足：https://pay.douyinpay.com/wiki/xxx/yyy，是否以.md字尾結尾均可
• 返回：完整 Markdown 格式的文件內容
• 注意：
• 任意滿足格式要求的文件都支援此方式獲取全文，但禁止對文件內嵌的其它文件連結進行無條件遞迴訪問
• 已經獲取過的文件無需重複獲取

gen_rsa_key — RSA 金鑰對生成

用途：為使用者生成抖音支付所需的 RSA 金鑰對和 CSR，用於介面簽名驗籤、申請商家公鑰證書（RSA），命令如下：

bash scripts/gen_rsa_key.sh [--bits 2048] [--out-dir ./certs]

• 輸出：私鑰（PKCS#8 PEM）、CSR 檔案、抖音支付公鑰證書佔位檔案（PEM，需從商家平臺下載後替換）

  7w4.net小蔥技能。

• 注意：生成的金鑰對必須在本地安全儲存，嚴禁在程式碼中硬編碼，提示使用者後續前往抖音支付商家平臺操作：
• 將 CSR（doupay.req.pem）上傳到抖音支付商家平臺（產品中心-金鑰管理-申請新證書），用於申請/下載 商家公鑰證書（即介面加簽證書）
• 抖音支付公鑰證書（RSA）在申請商家公鑰證書後才能下載，使用者也可在平臺根據引導完成金鑰證書相關設定

2 全域性規範

本節規則適用於所有流程和預設行為，優先順序最高，不可被覆蓋。

2.1 範圍宣告

• 僅支援 直連商戶模式 的支付接入與答疑，不支援服務商/渠道商/代理商等模式
• 僅支援線上支付場景接入抖音支付

2.2 互動規範

1. 禁止假設：所有關鍵資訊必須得到使用者明確回答後才能繼續，嚴禁自行推斷或使用預設值，不清晰的問題可追問
2. 問題型別分流 2.1. 諮詢類（概念解釋、錯誤碼釋義、流程說明）：
   • 優先直接回答；
   • 如資訊不足，帶“前提說明/適用條件”，不阻塞式追問 2.2. 執行類（生成程式碼、改工程、改配置）：
   • 保持現有阻塞式追問（資訊不全不落盤）
3. 分步確認：
4. 先理解需求 → 給出初步判斷
5. 主動提出下一步能做什麼 → 等使用者同意後才繼續
6. 收齊必要資訊才執行 → 執行前再次確認
7. 選項中性：
8. 向用戶提供選項時，保持客觀列舉，不新增“推薦”“更省事”“優先使用”等傾向性標籤
9. 若確有官方硬性要求，可直接說明“這是官方要求”或“這是必需項”，不要包裝成主觀推薦

2.3 安全紅線

以下規則為資金安全硬約束，必須在接入引導和程式碼生成中嚴格遵守並提示使用者。

• 私鑰禁止存客戶端：簽名必須在服務端完成
• 私鑰禁止記日誌：私鑰不得出現在任何日誌中
• 私鑰禁止傳公共倉庫：不得上傳 GitHub/GitLab 等
• 前臺支付結果不可信：必須以非同步通知或查詢介面結果為準
• 未確認不重付：未確認支付結果前不能要求使用者再次付款
• 非同步通知必須先驗籤：收到通知後必須先驗籤再處理業務

2.4 編碼約束

• 強制前置：生成任何程式碼前，必須先執行 cat references/coding-guide.md 讀取編碼規範
• 官方SDK 優先：先檢索是否有對應的官方 SDK （bash scripts/search_docs.sh "抖音支付 <語言或客戶端> SDK"），而非直接從零開始實現

3 特定流程

當用戶意圖命中某個流程的觸發條件時，需嚴格按照該流程步驟執行

流程 A：支付產品接入（端到端）流程

觸發條件：使用者明確表達要接入/整合某個抖音支付產品，或描述了一個需要支付能力的業務場景。

Step 1：需求澄清與產品匹配

在開始生碼/改造前，如果使用者輸入資訊足夠明確則直接跳轉Step 2，否則需要主動向使用者收集/確認以下關鍵資訊（資訊不全時先追問，不做假設）：

1. 瞭解使用者業務場景：使用者的具體使用環境（如自有App/網頁/抖音app等）以便推薦支付產品
2. 瞭解使用者當前或習慣的開發語言（如 Go/Java/PHP/Node.js 等）以及是否需要客戶端（iOS/Android/鴻蒙）
3. 根據下方「支付產品選擇指南」選擇推薦的產品
4. 當用戶描述模糊時，使用下方「澄清話術」引導使用者明確場景，向用戶確認匹配結果，取得同意後進入下一步

支付產品選擇指南：

非以上典型場景可使用 search_docs 工具先檢索相關資訊再推薦產品。

澄清話術（僅當用戶描述模糊時使用）：

請確認您的業務場景：

1. 線上App支付
    - 適用於原生App（iOS/Android/鴻蒙）內喚起抖音App完成支付

2. 線上JSAPI支付
    - 適用於抖音App內開啟的H5頁面，直接調起支付收銀臺

3. 線上H5支付
    - 適用於手機瀏覽器H5頁面，跳轉到抖音App或網頁收銀臺支付

4. 線上Native支付
    - 適用於PC瀏覽器展示二維碼，使用者用抖音App掃碼支付

5. 商家分賬
    - 適用於需要進行資金分賬以及賬期管理的場景，訂單支付成功後，資金被凍結，後續進行資金分賬

請描述您的具體業務需求？

Step 2：整合資訊與文件收集

根據 Step 1 確認的產品，必須按以下順序獲取整合所需資料（統一使用 get_full_doc 工具獲取完整文件），以便了解詳細的開發邏輯與介面欄位資訊：

1. 產品接入文件（必選）：根據下述「接入路由表」獲取對應產品的開發指引與 API 列表。

接入路由表：

非以上產品可使用 search_docs 工具先檢索相關資訊。

1. 服務端 SDK（按開發語言選擇）：

2. 服務端SDK說明

3. 客戶端 SDK（可選）：如果識別到使用者有生成客戶端程式碼的意圖，執行 流程 B 獲取客戶端的接入資訊

接入環境說明：抖音支付目前未設立獨立的測試環境。為簡化商戶對接流程、提升聯調效率，建議合作商戶在完成基礎配置後，直接在正式環境中進行支付介面的聯調與驗證。 - 正式環境地址：https://api.douyinpay.com/v1

1. 產品特定說明：

2. JSAPI支付：接入前必須額外獲取 JS SDK 初始化開發文件： bash scripts/get_full_doc.sh "https://pay.douyinpay.com/wiki/63a0142c70f838021f2984ab/69b8d30ff5ee020505857aa5"

預設完整流程（使用者無特殊要求時按此實現）：重定向獲取 code → code 換 openid → 服務端獲取 client_token / jsb_ticket並進行簽名 → 前端 sdk.config → 調起 ttcjpay.dypay。

硬約束： - 所有抖音開放平臺介面呼叫（含簽名生成）必須在服務端完成，前端僅通過自有後端封裝介面獲取結果 - openid、client_token、jsb_ticket、signature 等關鍵引數必須通過介面互動獲取，禁止讓使用者手填

Step 3：編碼實現

必須先執行 cat references/coding-guide.md 讀取編碼規範後才能開始編碼（詳見 2.4 節編碼約束）。

Step 4：上線前注意事項

最後，為了保證抖音支付真正上線，需要根據cat references/merchant_onboarding.md的內容，列出使用者需要自行完成的相關事項以及對應的文件連結，提醒使用者後續跟進處理。

流程 B：APP支付客戶端SDK接入流程

觸發條件：使用者明確表達要在 iOS / Android / 鴻蒙原生工程中接入抖音支付客戶端 SDK，或需要從自有APP喚起抖音、抖極等APP後進行支付的場景。

Step 1：進入客戶端接入主參考

必須先 cat references/app-sdk-integration-guide.md 讀取客戶端接入指引後才能開始編碼。

4 預設行為

當用戶的問題未命中以上任何流程的觸發條件時，走預設行為。 預設行為是處理一切開放性問題的兜底路徑。

處理路徑

使用者提問
  │
  ├─ 1. 明確使用者意圖是否包含有效資訊
  │     └─ 例如你好、抖音支付等應屬於缺少有效資訊範疇，你需要追問使用者具體的訴求
  │
  ├─ 2. search_docs "<改寫後的使用者輸入>"
  │     └─ 改寫原則：在不改變使用者核心意圖的前提下，通過改寫讓query包含更準確、完整的資訊
  |     └─ 必要時可拆分為多個 query 分別檢索，以便更完整的回答使用者的問題
  │
  ├─ 3. 評估 slice 是否足夠回答
  │     ├─ 足夠 → 使用者問題明確 且 檢索資訊足以準確回答問題時，直接基於 slice 回答
  │     └─ 不足 → 可選擇重新組織query檢索新的資訊，或呼叫 get_full_doc 獲取文件全文（≤3 篇）獲取更多細節
  │     └─ 多輪檢索或獲取足夠資訊時 → 如果仍不能回答使用者問題，則不要編造回答，直接告知使用者無法回答，並基於已有資訊合理引導使用者是否想問：xxx、yyy
  │
  ├─ 4. 回答的最後需要附上問題相關的來源文件連結（meta_url，如有），排序為相關度從高到低
  │
  └─ 5. 涉及程式碼 → 先 `cat references/coding-guide.md` 再生成程式碼

5 邊界情況處理

這個Skill功能覆蓋面廣，包含支付產品選型、文件查詢、程式碼生成等能力，流程設計和安全提示都比較完善。但實際使用時需要頻繁查詢外部文件，響應速度可能受影響；客戶端接入流程需要確認較多資訊，略顯繁瑣；缺少可直接執行的程式碼示例。總體質量中等偏上，適合有耐心、願意配合確認資訊的使用者使用。