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

項(xiàng)目地址：https://gitee.com/csweigou/douyin-pay-sdk-php

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

對(duì)接前準(zhǔn)備

1、在對(duì)接前，首先需要開通擔(dān)保支付的權(quán)限，關(guān)于這部分，我們微構(gòu)網(wǎng)絡(luò)之前已經(jīng)分享過相關(guān)內(nèi)容，具體內(nèi)容請(qǐng)參考《字節(jié)(抖音/頭條)小程序開通支付功能權(quán)限完整流程》。

2、開通擔(dān)保支付權(quán)限后，需要在小程序后臺(tái)的【功能管理】-【支付】-【擔(dān)保交易】-【擔(dān)保交易設(shè)置】中設(shè)置接口信息。

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

①、URL（服務(wù)器地址）：也就是回調(diào)地址，平臺(tái)服務(wù)端把發(fā)給應(yīng)用服務(wù)端的數(shù)據(jù)發(fā)送到這個(gè)地址（這里填寫的地址是默認(rèn)的地址，也可以在應(yīng)用發(fā)起支付請(qǐng)求的時(shí)候另外設(shè)置回調(diào)地址，優(yōu)先級(jí)：請(qǐng)求回調(diào)地址>此處回調(diào)地址，也就是說如果請(qǐng)求的時(shí)候設(shè)置了回調(diào)地址，則請(qǐng)求時(shí)設(shè)置的回調(diào)地址會(huì)覆蓋這里設(shè)置的）。這里需要自己設(shè)置。

②、token（令牌）：在回調(diào)驗(yàn)簽的時(shí)候需要用到，這里也需要自己設(shè)置（必須為英文或數(shù)字，長(zhǎng)度為3-32個(gè)字符）。

③、商戶號(hào)：平臺(tái)商戶號(hào)（系統(tǒng)自動(dòng)分配，無法修改）。

④、SALT：也就是鹽值，用于生成請(qǐng)求簽名是需要用到的（系統(tǒng)自動(dòng)分配，無法修改）。

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

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

接入指南（避坑指南）

1、必須設(shè)置回調(diào)地址才能發(fā)起支付、退款、分賬的請(qǐng)求，否則接口會(huì)報(bào)錯(cuò)。

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

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

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

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