跳轉到主要內容

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

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

發佈於 約 5 分鐘閲讀

手繪插畫:一個裝着 pay/plink 鏈接的聊天氣泡、一個信封和一張二維碼卡片,各有一個箭頭指向 $99.00 的收銀台,旁邊一個人朝它走來
本文目錄
  1. 收款鏈接是怎麼運作的?
  2. 如何創建收款鏈接
  3. 收款鏈接可以分享到哪裏?
  4. 如何限制或停用收款鏈接?
  5. 怎麼知道誰付了款?
  6. 收款鏈接和統一下單接口,該用哪一個?
  7. 收款鏈接要收費嗎?
  8. 用收款鏈接向海外買家收款
  9. 總結

收款鏈接是一個打開後就是現成收銀台的網址,金額固定。你只需創建一次,然後通過郵件、聊天或社交媒體發給買家,每位打開它的買家都可以用銀行卡或錢包付款,不用搭建收銀台,也不用寫代碼。對小商戶、自由職業者或剛上線的新產品來説,收款鏈接是開始網上收款最快的方式。

這篇文章説明收款鏈接如何運作、如何在 KukoPay 控制台或通過 API 創建收款鏈接、可以分享到哪裏、如何限制和停用,以及什麼時候應該從收款鏈接轉向統一下單接口。

收款鏈接是怎麼運作的?

在 KukoPay,收款鏈接是一個固定地址,例如 https://checkout.kukopay.com/pay/plink_7c2a41e9d8b30f56。在它背後:

  1. 每次訪問都會生成一筆新訂單,並把買家帶到收銀台。所以一個鏈接可以收任意多筆款,每一筆都是普通訂單,有自己的 trade_no,結算、退款和通知與 API 創建的訂單完全一樣。
  2. 回來的買家會回到自己的訂單。 同一個瀏覽器再次打開鏈接時,如果上次的訂單還沒付款、且剩餘有效期超過 10 分鐘,買家會回到那筆訂單,而不是再生成一筆。這樣買家去錢包或 3D Secure 頁面中途返回,也不會付兩次款。
  3. 兩個計數各管各的:used_count 統計鏈接生成過多少筆訂單(訪問次數),paid_count 統計成功收款多少筆。

沒人嘗試付款的訪問也是訂單,會隨收銀台鏈接一起過期。控制台的訂單列表默認不顯示它們,勾選「含收款鏈接未付款的訪問」即可看到。

如何創建收款鏈接

在控制台創建

打開 收款鏈接 頁面,選擇幣種、填寫金額,還可以選填買家看到的商品名稱和收款筆數上限,然後點擊 創建鏈接。在列表裏複製鏈接即可。這個頁面還可以在複製前選擇收銀台語言,之後也可以停用或重新啓用鏈接。

通過 API 創建

curl -X POST "https://api.kukopay.com/v1/payment_links" \
  -H "X-Api-Key: $KUKOPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 9900,
    "currency": "USD",
    "subject": "Pro plan, 1 year",
    "max_uses": 100,
    "expires_at": "2026-12-31T23:59:59Z",
    "metadata": { "campaign": "winter-2026" }
  }'
字段作用
amount每筆收款金額,最小貨幣單位的整數:9900 表示 $99.00
currencyUSD、HKD 或 CNY;正式鏈接只能用為你開通的幣種
subject買家在收銀台看到的標題
max_uses最多收多少筆成功支付,省略為不限
expires_at鏈接失效時間,省略為永久有效
notify_url該鏈接所生成訂單的通知地址;正式鏈接沒有它時,須有訂閲 payment.succeeded 的 Webhook 端點
return_url買家付款後跳回的地址;正式鏈接須為公網 HTTPS
metadata你自己的鍵值,會帶到鏈接生成的每一筆訂單上

響應裏的 url 就是要分享的地址。全部字段見 收款鏈接 API。

收款鏈接可以分享到哪裏?

只要能放網址的地方,收款鏈接都能用:

  • 郵件和賬單:在應付金額旁邊放一個「立即付款」鏈接;
  • 聊天:WhatsApp、微信、Telegram 或客服對話;
  • 社交媒體:個人簡介鏈接、帖子或私信;
  • 沒有商城的網站:放在落地頁的「購買」按鈕後面;
  • 印刷品:把網址做成二維碼,印在傳單或櫃枱上。

面向多種語言的買家?加上 ?locale=(en、zh、ja、ko、de),給每個受眾發各自的版本,例如 …/pay/plink_7c2a41e9d8b30f56?locale=ja。否則收銀台為英文,並且不跟隨瀏覽器語言;各個版本共用同一個鏈接、同一批訂單和計數。

如何限制或停用收款鏈接?

  • max_uses 計的是付款筆數,不是打開次數。 設為 1 的鏈接,有人打開後沒付就離開,不會用掉這個名額。多位買家同時搶最後一個名額時,先入賬的一筆計入,其餘的會自動全額退回,並發送 payment.duplicate_refunded,你的餘額不受影響。退款不會把名額還回來。
  • expires_at 在指定時間關閉鏈接,適合預售、活動和限時優惠。
  • 停用:用 "status": "inactive"(或在控制台點擊 停用),買家看到的是一個簡短的説明頁,而不是收銀台。鏈接不存在、已過期或已收滿時,也顯示同樣的説明頁。

鏈接的 status、subject、max_uses、expires_at 和 metadata 隨時可以修改。

為什麼收款鏈接不能改價?

鏈接創建後,金額和幣種就固定了。 已經發出去的鏈接,不能扣到與買家看到的價格不同的金額。需要改價時,停用舊鏈接,再新建一個。

怎麼知道誰付了款?

收款鏈接不需要對接,但你的系統仍然要知道每一筆付款:

  • Webhook。 每筆付款都會向鏈接的 notify_url 或你的 Webhook 端點發送 payment.succeeded。驗簽後只履約一次,做法見 Webhook 重複通知怎麼辦。
  • 訂單號。 鏈接生成的訂單,out_trade_no 形如 plink_7c2a41e9d8b30f56_3(鏈接 id + 第幾次訪問),metadata 裏帶有 kukopay_payment_link,任何一筆付款都能追溯到對應的鏈接和活動。
  • 收據。 每筆已支付訂單都有可打印的付款收據,可以發給買家,見 付款收據。

買家跳回你的 return_url 並不能證明已經付款,原因見 return_url 和 notify_url 的區別。

收款鏈接和統一下單接口,該用哪一個?

收款鏈接統一下單(POST /v1/orders)
需要寫代碼不需要每筆訂單一次服務端調用
價格每個鏈接固定每筆訂單單獨設置
一個鏈接給多位買家可以不可以,每次調用一筆訂單
你自己的訂單號由鏈接自動生成你的 out_trade_no
適合賬單、定金、商品不多、社交銷售、測試需求有購物車、套餐和訂單系統的網店或 SaaS

很多商戶先從收款鏈接開始,之後再接入 API;兩者共用同一個收銀台、同樣的費率和餘額。API 那一側見 網站如何接收國際付款。

收款鏈接要收費嗎?

創建和分享鏈接都免費,只有成功支付才收費,費率與其他訂單相同。標準價為 3.5% 加按幣種的固定費(USD $0.30、HKD HK$2.35、CNY ¥2.00),所以一筆 $99.00 的銀行卡付款手續費為 round(9900 × 3.5% + 30) = 377,即 $3.77。沒人付款的訪問不產生任何費用。更多示例見 跨境收款手續費怎麼算。

用收款鏈接向海外買家收款

收款鏈接打開的是同一個收銀台,所以海外買家可以用銀行卡、Apple Pay、Google Pay、PayPal,中國大陸的買家可以用支付寶和微信支付,具體取決於你賬戶已開通的方式。面向中文買家,發 ?locale=zh 的版本;兩個錢包的細節見 海外商戶如何接入支付寶和微信支付收款。還沒有公司?個人也可以收款,規則見 個人可以做跨境收款嗎。

總結

  • 收款鏈接是打開即付款的固定價格網址,每次訪問都是一筆獨立訂單;
  • 在控制台或用 POST /v1/payment_links 創建收款鏈接,然後分享到任何能放網址的地方;
  • max_uses 計成功付款筆數,expires_at 和停用可以關閉鏈接,價格永遠不變;
  • 以 Webhook 得知付款結果,而不是回跳;
  • 每筆訂單需要自己的價格或訂單號時,改用統一下單接口。

在沙箱裏把它跑通

註冊商戶後即可申請測試密鑰,不需要等待資質審核。