收款鏈接是什麼?如何創建和分享收款鏈接,不寫代碼也能收款
收款鏈接是什麼、如何在控制台或用 API 創建收款鏈接、可以分享到哪裏、如何限制收款筆數,以及什麼時候該改用統一下單接口。
收款鏈接是一個打開後就是現成收銀台的網址,金額固定。你只需創建一次,然後通過郵件、聊天或社交媒體發給買家,每位打開它的買家都可以用銀行卡或錢包付款,不用搭建收銀台,也不用寫代碼。對小商戶、自由職業者或剛上線的新產品來説,收款鏈接是開始網上收款最快的方式。
這篇文章説明收款鏈接如何運作、如何在 KukoPay 控制台或通過 API 創建收款鏈接、可以分享到哪裏、如何限制和停用,以及什麼時候應該從收款鏈接轉向統一下單接口。
收款鏈接是怎麼運作的?
在 KukoPay,收款鏈接是一個固定地址,例如 https://checkout.kukopay.com/pay/plink_7c2a41e9d8b30f56。在它背後:
- 每次訪問都會生成一筆新訂單,並把買家帶到收銀台。所以一個鏈接可以收任意多筆款,每一筆都是普通訂單,有自己的
trade_no,結算、退款和通知與 API 創建的訂單完全一樣。 - 回來的買家會回到自己的訂單。 同一個瀏覽器再次打開鏈接時,如果上次的訂單還沒付款、且剩餘有效期超過 10 分鐘,買家會回到那筆訂單,而不是再生成一筆。這樣買家去錢包或 3D Secure 頁面中途返回,也不會付兩次款。
- 兩個計數各管各的:
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 |
currency | USD、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 得知付款結果,而不是回跳;
- 每筆訂單需要自己的價格或訂單號時,改用統一下單接口。
在沙箱裏把它跑通
註冊商戶後即可申請測試密鑰,不需要等待資質審核。