# 字節小程序擔保支付簡介 > 開發者可以申請擔保支付交易，讓用戶能夠在電商、生活服務、知識付費等多種場景下，在小程序完成支付閉環，提升用戶的支付體驗，保障資金安全。 ## [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/RE#%E6%8B%85%E4%BF%9D%E6%94%AF%E4%BB%98%E8%83%BD%E5%8A%9B)擔保支付能力 ### [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/RE#%E5%90%8D%E8%AF%8D%E8%A7%A3%E9%87%8A)名詞解釋 | 名詞 | 釋義 | | --- | --- | | 商戶 | 用于承接擔保支付交易的賬戶，用戶支付后，款項會進入賣家賬戶的凍結金額 | | 進件 | 指提交支付相關資質并開通支付賬號的流程 | | 支付秘鑰 | 擔保支付使用了一套獨立的秘鑰，非 app secret，加簽邏輯參考附錄 | | 結算 | 商戶賬戶中的凍結金額需要進行結算將凍結金額結算至可提現金額。同時如果對賣家收到的款項有分配的需要，也需要在結算環節明確各方的分配金額。貨款會在結算后進入各個分賬方的可提現賬戶中 | | 分賬方 | 參與結算的非賣家用戶，可以獲分一定金額的貨款。但分配金額之和不能超過支付訂單金額的 30% | | 服務商 | 幫助開發者（業務方）進行小程序的開發者、運營的團隊和公司 | | 第三方平臺 | 第三方平臺（TP）是指服務商進行開發、管理、運營小程序并從此獲取收益的平臺；**小程序運營者，可以一鍵授權給第三方平臺，通過第三方平臺來完成業務**[第三方平臺網頁鏈接](https://open.microapp.bytedance.com/?is_new_connect=0&is_new_user=0) | | 支付授權 | 在第三方平臺開發模式中，向第三方授權管理擔保支付功能。在授權時，需要配置允許其對外分配的金額上限 | ### [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/RE#%E5%BC%80%E5%8F%91%E8%80%85%E6%A8%A1%E5%BC%8F)開發者模式 開發者模式，是指具有支付進件資格的主體，接入擔保支付后，所有的貨款進入唯一的一個擔保支付賬戶中。后續的結算不需要分賬給其他第三方。 接入者需要在小程序開發者平臺上完成擔保支付的申請后，在平臺完成小程序對應擔保支付賬戶的進件。開發接入**支付下單，退款，結算**三個環節即可。 ### [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/RE#%E6%9C%8D%E5%8A%A1%E5%95%86%E6%A8%A1%E5%BC%8F)服務商模式 服務商模式接入，主要是指需要有使用服務商身份進行支付開發的，以及以服務商身份對交易貨款進行分賬。無以上兩種需求的服務商可以**按獨立開發者模式接入**。 服務商首先需要入駐第三方平臺后，進行**支付授權**。支付授權完成后，就可以按第三方進件中的**服務商進件**獲取服務商進件頁面。進件完成后，可以得到一個服務商專屬的**支付秘鑰**。使用該秘鑰就可以進行支付開發。開發接入**支付下單，退款，結算**三個環節即可，在結算環節時可以傳入參數，為自己分配授權額度以下的金額（**對外分配比例之和少于整筆交易金額的 30%**）。 當存在涉及服務商，賣家之外的額外分賬方時，需要以服務商身份（必須完成服務商入駐）按第三方進件中的**第三方進件**，為每一個分賬方操作進件。在結算環節時可以傳入參數，為各個分賬方按情況分配授權額度以下的金額（**服務商和額外分賬方的分配金額之和必須少于整筆交易金額的 30%**）。 ### [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/RE#%E8%BF%9E%E9%94%81%E9%97%A8%E5%BA%97%E6%A8%A1%E5%BC%8F)連鎖門店模式 對于一些場景，同一小程序需要承接不同賣方的交易行為（**賣方獲得大部分貨款，受限于對外分賬額度上限，不能使用分賬完成分配**）。例如連鎖門店的交易小程序，需要使用統一小程序承載交易，但貨款由每一個門店的擔保支付賬戶接收。 需要使用連鎖門店模式的商戶應向開發者平臺進行申請，提供相關的資質證明及門店授權合作協議，與平臺簽訂分賬協議后方可使用該種模式下的相關功能。 # 接入流程 ## [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/TE#%E6%8E%A5%E5%85%A5%E5%87%86%E5%A4%87)接入準備 ## [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/TE#%E7%94%B3%E8%AF%B7%E5%BC%80%E9%80%9A%E6%94%AF%E4%BB%98%E8%83%BD%E5%8A%9B)申請開通支付能力 小程序在申請開通支付能力前，應在小程序【開發者平臺-功能管理-支付】界面閱讀并同意《擔保交易功能通知》，之后方可申請開通使用。 ### [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/TE#%E8%BF%9B%E4%BB%B6)進件 **開通條件** 小程序需已通過主體認證，且完成基本信息配置。 **開通支付賬號** 進入小程序開發者平臺（[microapp.bytedance.com](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/microapp.bytedance.com)）-功能管理-支付-擔保交易開通。 **資質填寫** 按提示填寫商戶、法人信息，管理員信息、結算信息，需由支付寶、微信審核需 2-3 個工作日。 1. 商戶基本信息及證件圖片 * 商戶類別：可選擇 個人（持續從事電子商務經營活動滿 6 個月且期間經營收入累計超過 20 萬元。）/企業/個體工商戶/小微 * 商戶名稱：需與證件內容一致 * 商戶簡稱：用于支付時向買方展示 * 商戶證件類型及編號：營業執照（統一社會信用代碼）即三證合一之后的 * 商戶證件是否為長期及有效期至 * 協議確認賬號 2. 法人基本信息及證件圖片 * 法人姓名：需與身份證等證件內容展示一致 * 證件類型及證件號 * 商戶證件是否為長期及有效期至 3. 管理員信息 * 管理員姓名 * 管理員手機號碼 * 管理員身份證號 * 管理員郵箱 4. 結算信息 * 結算卡屬性：對公 * 開戶銀行省份、城市等 * 開戶銀行、開戶支行 * 結算卡卡名及卡號：僅支持儲蓄卡，不支持信用卡 * 銀行預留手機號 * 支付寶結算類型、支付寶結算賬號 **驗證簽約** 驗證后即進入等待審核環節，審核時間預計 2-3 個工作日。 微信支付簽約認證環節需使用管理員微信掃碼進行確認。 完成后重新進入支付頁面則如下顯示： **微信和支付寶進件成功后，用戶可以通過微信和支付寶在小程序內進行支付。** ### [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/TE#%E6%94%AF%E4%BB%98%E8%AE%BE%E7%BD%AE)支付設置 支付設置中需對該小程序的 URL、Token、SALT 進行配置。 * 商戶號：小程序平臺自動分配 * URL：服務端地址，必須以 https 開頭，支持 443 端口 * Token：小程序平臺向開發者服務端發送請求時的密鑰，必須為英文或數字，長度為 3-32 個字符 * SALT：向小程序平臺發送請求時的密鑰 ### [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/TE#%E6%94%AF%E4%BB%98%E6%8E%88%E6%9D%83%EF%BC%88%E6%9C%8D%E5%8A%A1%E5%95%86%E6%A8%A1%E5%BC%8F%EF%BC%89)支付授權（服務商模式） 對于使用第三方平臺模式開發小程序的用戶。需要針對小程序擔保支付，根據文檔[字節小程序第三方接入文檔](https://microapp.bytedance.com/docs/zh-CN/mini-app/thirdparty/overview-guide/development-process/)進行專門的支付行為授權，并且完成服務商的進件，才可以繼續在第三方平臺模式下接入擔保支付能力。 為了便于服務商對進件與賬戶信息的管理。擔保支付通過提供接口獲取進件與賬戶頁面 URL 方式完成進件。具體參考接口[第三方進件部分](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/YE#%E7%AC%AC%E4%B8%89%E6%96%B9%E8%BF%9B%E4%BB%B6)。 ### [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/TE#%E7%AC%AC%E4%B8%89%E6%96%B9%E8%BF%9B%E4%BB%B6%EF%BC%88%E6%9C%8D%E5%8A%A1%E5%95%86%E6%A8%A1%E5%BC%8F%EF%BC%89)第三方進件（服務商模式） 如果在業務場景中涉及小程序，服務商之外的第三方參與交易，則需要在完成服務商進件后，以服務商身份請求接口，參考第三方進件接口[](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/TE)為第三方獲取進件頁面與賬戶頁面 URL，完成進件。 ### [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/TE#%E6%94%AF%E4%BB%98%E8%83%BD%E5%8A%9B%E6%8E%A5%E5%85%A5)支付能力接入  > 服務端接入 * 用戶在商戶側通過接口完成商品的預下單 * 商戶后端生成商品訂單信息，并調用小程序平臺后端預下單接口進行預下單 * 商戶后端將預下單獲取的 orderInfo 返回給商戶前端 > 前端（小程序）接入 * 前端（小程序）調用 tt.pay 接口，調起小程序收銀臺，發起支付流程 * 前端（小程序）接收支付結果回調，進行后續業務處理 ### [](https://microapp.bytedance.com/docs/zh-CN/mini-app/develop/api/open-interface/payment/secure/TE#%E5%89%8D%E7%AB%AF%EF%BC%88%E5%B0%8F%E7%A8%8B%E5%BA%8F%EF%BC%89%E6%8E%A5%E5%85%A5)**前端（小程序）接入** 商戶前端在接收到后端返回的 orderInfo 后就可以直接調用 tt.pay 拉起收銀臺了 1. 輸入 | 屬性 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | success | function | 否 | 接口調用成功的回調函數 | | fail | function | 否 | 接口調用失敗的回調函數 | | orderInfo | object | 是 | 調起小程序支付收銀臺訂單信息 | | service | number | 是 | 固定值：5 | orderInfo 屬性如下： | 屬性 | 類型 | 必填 | 說明 | | --- | --- | --- | --- | | order\_id | string | 是 | 商戶后端在字節跳動平臺預下單獲取的訂單號 | | order\_token | string | 是 | 商戶后端在字節跳動平臺預下單獲得的訂單 Token | > orderInfo 是相對于非擔保交易收銀臺參數變化最大的部分；在新的擔保交易模式下，商戶服務端在小程序平臺服務端下單（參考服務端接入），獲得 orderInfo，并最終透傳至 tt.pay，傳輸鏈路上的字段更少。 2. 輸出 success 返回參數說明 | 屬性 | 類型 | 說明 | | --- | --- | --- | | code | number | 支付狀態碼：0-支付成功，1-支付超時，2-支付失敗，3-支付關閉，4-支付取消，9-訂單狀態開發者自行獲取 | > 只要調起收銀臺成功，支付狀態都會回調 success 返回，開發者依據返回的 code 值，進行后續業務邏輯處理 ~~~js 代碼示例; ~~~ ~~~js tt.pay({ service: 5, orderInfo: { order_id: "6819903302604491021", order_token: "CgsIARCABRgBIAQoARJOCkx+WgXqCUIwTel2V3siEGZ0++poigIM+SMMxtMx798Vj0ZYzoTYBqeNslodUC9X5KAOHkR1YbSBz6I6pXATh5faIGy7R72A9vwm0OczGgA=", }, success(res) { if (res.code === 0) { // 支付成功處理邏輯，只有res.code=0時，才表示支付成功 // 但是最終狀態要以商戶后端結果為準 } }, fail(res) { // handle fail }, }); ~~~