海外商戶如何接入支付寶和微信支付收款?完整指南
海外商戶如何接入支付寶和微信支付收款:買家怎麼付款、如何開通兩個錢包、手續費、退款期限,以及在沙箱裏怎麼測試。
本文目錄
接入支付寶和微信支付收款,不需要中國公司,也不需要分別和兩個錢包簽約。通過一家已經支持它們的跨境支付服務商,就能把兩個錢包和銀行卡一起加到你的收銀台上。在 KukoPay,支付寶和微信支付是同一個託管收銀台、同一套 API 裏的支付方式:中國大陸的買家用每天都在用的 App 付款,你收到的入賬和通知與銀行卡支付完全一樣。
這篇文章説明支付寶和微信支付收款與銀行卡有哪些不同:買家怎麼付款、如何開通、費用多少、最容易讓商戶吃虧的退款期限,以及上線前如何把這一切在沙箱裏測一遍。
為什麼要接入支付寶和微信支付?
對很多中國大陸買家來説,在網上付款靠的是錢包,而不是銀行卡。只支持國際信用卡的收銀台,恰恰會在最後一步流失這部分買家。在銀行卡之外提供支付寶和微信支付,每位買家都能用自己習慣的方式付款,不用輸入卡號,也不用在心裏換算匯率。
在 KukoPay,兩個錢包屬於同一個 local_wallet 渠道,通過同一種申請開通,並和其他支付方式一樣入賬到按幣種分開的餘額。
買家如何用支付寶或微信支付付款?
和銀行卡不同,錢包支付是在錢包裏完成授權的:
| 支付寶 | 微信支付 | |
|---|---|---|
| 買家要做什麼 | 跳轉到支付寶,在那裏確認付款 | 用微信掃描二維碼,在 App 裏確認付款 |
| 之後回到哪裏 | 回到收銀台 | 回到收銀台 |
| 怎麼知道已付款 | payment.succeeded Webhook | payment.succeeded Webhook |
買家要離開你的頁面,由此帶來兩點:
- 回跳不能證明已付款。 買家可能在錢包裏付完款卻沒回來,也可能在支付確認前就回來了。只以驗簽後的 Webhook 或服務端查詢訂單的結果履約,原因見 return_url 和 notify_url 的區別。
- 買家改主意是安全的。 如果買家發起了錢包支付,又回到收銀台改用銀行卡,收銀台會先取消那筆未完成的錢包支付,再發起新的支付。如果買家其實在這期間已經付了款,就按這筆付款入賬,不會讓買家付第二次。極少數情況下,付款在訂單已支付或已過期之後才到達,平台會自動全額退回給買家,並發送
payment.duplicate_refunded。
如何用 KukoPay 開通支付寶和微信支付收款
先在沙箱裏測試
沙箱提供全部支付方式,包括支付寶和微信支付,不需要申請。測試方法見下文「如何測試支付寶和微信支付?」。
完成資質審核
中國大陸企業、個體工商戶、境外公司和個人都可以申請。境外公司用自己的註冊證書審核,不需要中國主體。見 商戶入駐與審核。
開通兩個錢包
審核通過時會開通一組基礎支付方式。如果其中沒有支付寶或微信支付,在控制台 設置 → 支付方式 中點擊它旁邊的「申請開通」,並説明業務場景。為其中一個確定的費率適用於整個 local_wallet 渠道,另一個也一併適用。
照常創建訂單
API 裏沒有任何錢包專屬的寫法。用 POST /v1/orders 創建訂單,或者分享一個 收款鏈接,收銀台就會向買家展示這兩個錢包。任何已開通的方式都可以自行關閉展示,不需要找平台。
給中文買家顯示中文收銀台
收銀台默認是英文,並且不跟隨瀏覽器語言。下單時傳 "locale": "zh",或在 checkout_url 後追加 &locale=zh(收款鏈接用 ?locale=zh),讓中國客戶看到中文頁面。
如果你的網店系統支持易支付協議,什麼都不用開發:支付寶和微信支付會自動出現在收銀台上,通知裏的 type 會報告買家實際使用的方式,即 alipay 或 wxpay。簽名和通知細節見 易支付接入指南。
支付寶和微信支付收款的手續費是多少?
支付寶和微信支付同屬 local_wallet 渠道,一起定價。標準價為每筆成功支付 3.5% 加訂單幣種的固定費(USD $0.30、HKD HK$2.35、CNY ¥2.00),與銀行卡的標準價相同,簽約費率可以按渠道不同。
¥268.00 訂單,買家用微信支付
手續費 = round(26800 × 3.5% + 200) = 1138 → ¥11.38
入賬淨額 = 26800 - 1138 = 25662 → ¥256.62訂單對象上的 fee_details 記錄實際適用的費率,其中 fee_group 為 "local_wallet",之後調價不會改寫已入賬的訂單。更多示例(包括小額訂單)見 跨境收款手續費怎麼算。
支付寶和微信支付的退款有期限
這是商戶最常在事後才發現的區別:支付寶和微信支付的付款,只能在付款後的一段時間內退款。
KukoPay 把這個期限寫在訂單的 refundable_until 上(支付方式沒有已知期限時為 null)。超過期限的退款請求會返回 HTTP 400 和 refund_window_expired:不會扣減你的餘額,也不會發送給通道。期限過後的退款只能與買家線下協商處理。
應對方法:
- **保存訂單時讀取
refundable_until,**並在客服看到的訂單信息旁邊顯示出來。 - **及時處理退款請求,**不要攢到月底批量處理。
- 需要時分多次退款。 支持多次部分退款,累計不超過訂單金額,手續費不隨退款退回。見 申請退款。
支付寶和微信支付訂單應該用哪個幣種?
訂單可以用 USD、HKD 或 CNY 創建(正式環境使用為你開通的幣種)。每個幣種是獨立的錢包餘額:CNY 訂單以 CNY 入賬、以 CNY 退款、以 CNY 提現,平台不做自動換匯。收銀台只展示當前訂單實際可用的支付方式,所以某個方式不能處理這筆訂單時,它不會出現,而不是在最後一步付款失敗。
如果你的支付寶和微信支付買家大多在中國大陸,而你也以 CNY 提現,那麼這些商品用 CNY 標價,整條鏈路都在一個幣種裏。如何選擇幣種,見 網站如何接收國際付款。
如何測試支付寶和微信支付?
在沙箱裏,收銀台選擇支付寶或微信支付後,會打開一個測試授權頁,而不是真實的錢包。在這個頁面上你可以:
- 授權:訂單變為
paid並發送payment.succeeded,即使買家在授權頁直接關閉瀏覽器也一樣; - 拒絕:訂單保持
pending,買家可以換一種方式付款; - 不做選擇直接返回:未完成的支付會先被取消,再發起新的支付,之後在舊授權頁上的操作不會再扣款。
用這三種情況檢查你的回跳頁面只讀取狀態,以及 Webhook 處理對每筆訂單只履約一次,做法見 Webhook 重複通知怎麼辦。完整的沙箱場景見 沙箱測試。
總結
- 通過跨境支付服務商就能接入支付寶和微信支付收款,不用分別和錢包簽約;
- 買家在錢包裏確認付款(支付寶跳轉,微信支付掃碼),所以以 Webhook 履約,而不是回跳;
- 在 KukoPay,兩個錢包同屬
local_wallet渠道:標準價 3.5% 加幣種固定費; - 錢包退款有期限
refundable_until,請及時退款; - 用
locale=zh給中國客戶顯示中文收銀台; - 上線前在沙箱裏測一遍授權、拒絕和中途放棄。
在沙箱裏把它跑通
註冊商戶後即可申請測試密鑰,不需要等待資質審核。