跳轉到主要內容沙箱環境免費開通,幾分鐘內跑通第一筆測試訂單

博客

支付接入,把每個細節講清楚。

我們在搭建支付鏈路時踩過的坑、做過的取捨和驗證過的做法。每篇文章都對應可以直接照做的接入文檔。

RSS 訂閲
  1. 手繪插畫:一部手機屏幕上顯示帶勾的盾牌和六位驗證碼,一張銀行卡有箭頭指向手機,旁邊一個人指着它

    3D Secure 是什麼?3DS 驗證如何運作,對商戶意味着什麼

    3D Secure 是什麼、3DS 驗證如何運作、無感驗證與挑戰驗證的區別、3D Secure 驗證為什麼會失敗,以及上線前如何在沙箱裏測試。

  2. 手繪插畫:一張畫着叉的銀行卡,周圍是 do_not_honor、insufficient_funds、expired_card 標籤,旁邊一個雙手抱臂、一臉困惑的人

    銀行卡支付被拒怎麼辦?do not honor 等拒絕代碼的含義與處理方法

    銀行卡支付被拒絕代碼詳解:do not honor、餘額不足、安全碼錯誤分別代表什麼,軟拒絕與硬拒絕的區別,以及商戶如何挽回這筆訂單。

  3. 手繪插畫:一個商城頁面用箭頭跳轉到一個獨立的收銀台頁面,上面有鎖、Logo 和品牌色色塊,旁邊一個人指着它

    託管收銀台是什麼?託管支付頁與自建收銀台的區別、PCI 合規與品牌設置

    託管收銀台(託管支付頁)是什麼、和自建收銀台有什麼區別、對 PCI 合規範圍有什麼影響,以及如何設置品牌、讓買家付款後回到你的網站。

  4. 手繪插畫:三張帶着相同 Idempotency-Key 的請求卡片進入同一個服務器,只返回一個 201 響應,旁邊有一把鑰匙和一個雙手抱臂的人

    冪等鍵(Idempotency Key)是什麼?支付接口如何安全重試、不重複扣款

    冪等鍵是什麼、支付接口為什麼需要它、Idempotency-Key 請求頭如何重放響應,以及如何寫出永遠不會重複扣款的重試邏輯。

  5. 手繪插畫:一份蓋了印章的公司證照、一張身份證件和放大鏡下的核對清單,旁邊有已通過的狀態標籤和一個朝它們走來的人

    KYB 驗證是什麼?企業開通收款賬戶需要準備哪些資料

    KYB 驗證是什麼、和 KYC 有什麼區別、支付服務商要求企業提供哪些資料、審核如何進行,以及如何一次通過 KYB 審核。

  6. 手繪插畫:一張 48.00 的收據撕下了 20.00 的一角,箭頭把它送回錢包,旁邊站着一個雙手插兜的人

    部分退款怎麼操作?退款多久到賬、手續費會不會退回一次講清

    網上收款的部分退款如何操作:怎樣發起部分退款、退款多久完成、為什麼手續費不退、支付寶和微信支付的退款期限,以及拒付期間能否退款。

  7. 手繪插畫:一個裝着 pay/plink 鏈接的聊天氣泡、一個信封和一張二維碼卡片,各有一個箭頭指向 $99.00 的收銀台,旁邊一個人朝它走來

    收款鏈接是什麼?如何創建和分享收款鏈接,不寫代碼也能收款

    收款鏈接是什麼、如何在控制台或用 API 創建收款鏈接、可以分享到哪裏、如何限制收款筆數,以及什麼時候該改用統一下單接口。

  8. 手繪插畫:一張帶編號、蓋了已付款印章的付款收據,一個信封從它飛出,旁邊有一台打印機和一個雙手抱臂的人

    付款收據和發票有什麼區別?網上收款後如何給買家發送付款收據

    付款收據是什麼、應該包含哪些內容、如何在付款後自動給買家發送付款收據,以及收據和發票、税務發票有什麼區別。

  9. 手繪插畫:訂單列表、資金流水和銀行對賬單三欄用連線一一對應並打了勾,旁邊一個朝它們走來的人

    支付對賬怎麼做?把訂單、手續費、退款和提現與銀行流水一一對上

    支付對賬實操指南:訂單與付款怎麼對、用資金流水解釋餘額、提現怎麼和銀行到賬對上,以及常見的對不上的原因。

  10. 手繪插畫:一張已支付的收據、一個顯示可用餘額的錢包和一座銀行建築,用箭頭依次相連,旁邊一個人坐在一摞硬幣上

    支付結算是什麼?一筆付款成功後,錢是怎樣到你銀行賬戶的

    支付結算是什麼、結算需要多久、可用餘額與可提現餘額有什麼區別、提現如何到達你的銀行賬戶,以及哪些情況會讓資金暫時無法提現。

  11. 手繪插畫:一疊扇形展開、分別標着 4242、3220 和 0002 的測試卡,旁邊是一張打了勾的清單和一個咧嘴笑、雙手抱臂的人

    支付測試卡號大全:每種支付結果的測試卡,以及卡號之外還要測什麼

    支付測試卡號大全:支付成功、各種被拒原因和 3D Secure 的測試卡號,如何在支付沙箱中使用,以及 Webhook、退款和錢包等同樣重要的測試。

  12. 手繪插畫:一個信封被帶紅叉的服務器彈回,下方是 30s、2m、10m、30m、2h 的重試時間線和一個放大鏡,旁邊一個雙手插兜、一臉擔心的人

    收不到支付 Webhook 回調怎麼辦?排查原因並補回漏掉的事件

    收不到支付 Webhook 回調時的排查清單:先看投遞記錄,再查回調地址、超時、驗簽和事件訂閲,最後通過事件接口補回漏掉的事件。

  13. 手繪插畫:一部手機屏幕上顯示二維碼、¥268.00 金額和已支付按鈕,支付寶和微信支付標籤指向它,旁邊站着一個微笑的人

    海外商戶如何接入支付寶和微信支付收款?完整指南

    海外商戶如何接入支付寶和微信支付收款:買家怎麼付款、如何開通兩個錢包、手續費、退款期限,以及在沙箱裏怎麼測試。

  14. 手繪插畫:一個帶有 USD、HKD、CNY 幣種按鈕和銀行卡、支付寶、微信支付、PayPal 選項的收銀台窗口,旁邊有一個地球儀和一個指向它的人

    網站如何接收國際付款?跨境收款的幣種、支付方式與手續費

    網站如何接收國際付款:多幣種收銀台、銀行卡與錢包支付方式、跨境收款手續費、提現規則,以及正式上線前的檢查清單。

  15. 手繪插畫:一張銀行卡上方畫着一個向回指的箭頭,下方寫着 0.9%,旁邊的人抱着胳膊面露擔憂

    信用卡拒付(Chargeback)是什麼?拒付率閾值、舉證材料與資金變化全解

    拒付是買家繞過商戶、直接向發卡行爭議一筆交易。本文説明拒付發生時資金如何凍結、餘額為什麼會變成負數、0.65% 與 0.9% 兩個拒付率閾值,以及按拒付原因該準備哪些證據。

  16. 手繪插畫:一張寫着 amount 2990、fee 135、net 2855 的收據,旁邊的人坐在一摞硬幣上

    跨境收款手續費怎麼算?費率公式、小額訂單與提現成本的完整示例

    以 KukoPay 標準價為例,拆解「比例費率 + 固定費」的計算方式、USD/HKD/CNY 三個幣種的固定費、小額訂單的實際費率為什麼會很高,以及退款、拒付和提現帶來的其他成本。

  17. 手繪插畫:一張寫着 pid、money、sign 參數的易支付請求單,旁邊的人指着它講解

    易支付接口對接指南:MD5 簽名、異步通知與訂單超時的三個坑

    易支付(epay)協議的 submit.php、mapi.php 和 api.php 怎麼對接?本文講清簽名算法、為什麼只通知支付成功、訂單有效期該怎麼設,以及驗簽失敗和收不到通知的排查方法。

  18. 手繪插畫:一張標着 18+ 的身份證件和一個地球儀,旁邊的人正開心地走過來

    沒有營業執照,個人能開通海外收款嗎?個人商戶的條件、限額與提現規則

    年滿 18 週歲的個人可以憑本人證件開通 KukoPay 收款。本文説明需要準備的材料、不能經營的類目、單筆 / 近 24 小時 / 近 30 天的收款限額、只能提現到本人賬戶的規則,以及證件過期後怎麼辦。

  19. 手繪插畫:三封寫着同一個事件 ID 的信封進入一個帶唯一約束的數據庫,只被記錄一次

    支付回調重複通知怎麼辦?用 Webhook 驗簽與冪等防止重複發貨

    支付平台的 Webhook 會重試,同一筆支付可能通知你兩次甚至更多。本文用 HMAC-SHA256 驗簽、事件 ID 唯一約束和數據庫事務,講清怎樣讓一筆支付只履約一次,以及回調全部丟失時如何補回。

  20. 手繪插畫:瀏覽器地址欄顯示 return?paid=1,頁面中間是一個問號,旁邊一個人懷疑地看着

    return_url 和 notify_url 有什麼區別?為什麼不能用支付回跳判斷支付成功

    買家付款後跳回你的頁面,不代表錢已經到賬。本文對比同步回跳 return_url 與異步通知 notify_url,列出回跳缺失、提前或被偽造的真實場景,並給出判斷支付成功的正確做法。