在開發(fā)抖音小程序過程中，不少場景可能需要使用到支付，而字節(jié)跳動目前沒有自己的支付平臺，因此只能使用微信和支付寶二級商戶的方式進行對接開發(fā)。然而截止目前，抖音官方關于這一塊的資料是比較少的，不僅沒有系統全面的SDK供參考，哪怕是碎片化的demo的數量也并不是太多。在開發(fā)群中已經出現多位開發(fā)者類似提問了，為了讓廣大開發(fā)者朋友少走點彎路、少填一點點坑，微構網絡向大家分享簡易版的對接示例代碼，我們稱之為douyin-pay-sdk-php。

項目地址：https://gitee.com/csweigou/douyin-pay-sdk-php

主要包括的API包括：1、發(fā)起支付；2、回調（含支付、退款、分賬）；3、支付訂單查詢；4、退款；5、分賬；其他的關于退款查詢和分賬查詢可以根據已有的demo自己快速實現。需要說明的是，這個項目僅僅是初始跑對接流程用的，可能并不是特別完善，不建議直接應用項目，建議進行適當修改后再引入到項目中（尤其是安全相關）。

對接前準備

1、在對接前，首先需要開通擔保支付的權限，關于這部分，我們微構網絡之前已經分享過相關內容，具體內容請參考《字節(jié)(抖音/頭條)小程序開通支付功能權限完整流程》。

2、開通擔保支付權限后，需要在小程序后臺的【功能管理】-【支付】-【擔保交易】-【擔保交易設置】中設置接口信息。

上述設置字段相信有其他平臺開發(fā)經驗的小伙伴應該一看就知道啥意思，這里為了照顧新手，還是依次講解一遍：

①、URL（服務器地址）：也就是回調地址，平臺服務端把發(fā)給應用服務端的數據發(fā)送到這個地址（這里填寫的地址是默認的地址，也可以在應用發(fā)起支付請求的時候另外設置回調地址，優(yōu)先級：請求回調地址>此處回調地址，也就是說如果請求的時候設置了回調地址，則請求時設置的回調地址會覆蓋這里設置的）。這里需要自己設置。

②、token（令牌）：在回調驗簽的時候需要用到，這里也需要自己設置（必須為英文或數字，長度為3-32個字符）。

③、商戶號：平臺商戶號（系統自動分配，無法修改）。

④、SALT：也就是鹽值，用于生成請求簽名是需要用到的（系統自動分配，無法修改）。

⑤、分賬周期：也就是可提現的周期，比如上面是T+7,這個也是沒辦法修改的。

⑥、技術服務費：手續(xù)費，這個很好理解，也是不能修改的，上面顯示的默認的0.6%。

接入指南（避坑指南）

1、必須設置回調地址才能發(fā)起支付、退款、分賬的請求，否則接口會報錯。

2、請注意token和salt的區(qū)別，salt是用于發(fā)起請求時生成簽名用的，token是接受回調信息進行來源驗簽用的，切記別搞混了。

3、由于網絡波動回調新可能會出現一次兩條推送，也可能延遲推送（特別退款回調幾乎都要10s+才能收到回調），而且官方文檔中也說不能完全依賴回調，應根據實際情況用查詢接口來輔助判斷（但官方文檔寫的查詢API的并發(fā)是30，這有點囧）。下圖是官方文檔的時序圖

4、回調接口務必需要根據業(yè)務做處理，如果訂單回調業(yè)務邏輯處理完成，務必給平臺服務端返回{ “err_no”: 0, “err_tips”: “success” }，否則平臺會多次推送重復的回調信息。

5、不管是請求簽名還是回調驗簽，算法務必嚴格按照官方文檔說明，務必注意去除不需要的字段值，如回調驗簽務必移除推送的回調信息中的type、msg_signature、可能的空字段（正常情況下沒有空字段返回）。