海外客戶把商品加進購物車,結帳頁面卻只列出一種陌生的本地刷卡方式,猶豫了幾秒,分頁就被關掉,訂單消失在半路。這種情況在跨境電商與接海外案子的自由工作者身上天天上演,對方不是不想買,而是不認得這個收款方式,不敢把卡號輸進一個看起來陌生的網站。
WooCommerce PayPal 串接要解決的正是這個信任落差。把商店連到一個 PayPal 商業帳戶,讓顧客能用他原本就在用的 PayPal 餘額、綁定信用卡或 Venmo 結帳,錢直接進到商家自己的 PayPal 帳戶,不必先問「這個網站能不能收我的錢」。PayPal 是一條國際收款路徑,跟本地金流方案是不同的選擇邏輯,沒有哪個絕對比較好的問題,跨境賣家與接海外案子的工作者最先感受到差異,純內銷、顧客都在台灣的商店用不太到,但先弄懂概念也無妨。
串接聽起來像裝一個外掛就好,實際上要先申請帳戶、跑完連接精靈、確認幾個容易被忽略的設定,少一步都可能讓顧客已經付了錢,訂單卻進行不下去。
WooCommerce 串接 PayPal 是什麼?兩種收款情境和適用對象
「串接」這兩個字常被誤解成裝一個外掛就處理完,但 WooCommerce PayPal 串接實際上是把商店連到一個 PayPal 商業帳戶,外掛只是負責溝通的橋樑,真正收錢的是那個帳戶。裝完外掛,商店還得完成一次帳戶授權,把 WooCommerce 後台的訂單資料與 PayPal 帳戶綁在一起。外掛負責把「顧客要付多少錢、買了什麼」傳給 PayPal,PayPal 負責處理實際扣款與資金保管,兩邊的角色分得很清楚。
這跟一般信用卡金流走的路徑不太一樣。顧客用信用卡在商店直接刷卡時,錢的路徑是從顧客的發卡銀行到商家申請的收單機構帳戶,中間不會經過第三方帳戶;但顧客用 PayPal 結帳時,錢會先進到顧客的 PayPal 帳戶,或直接扣他綁定的卡,再由 PayPal 轉進商家自己的 PayPal 商業帳戶,商家等於多了一個資金的中繼站。這個差異也解釋了為什麼提領、手續費、幣別轉換都要另外算一套,後面幾節會逐一拆開講。
真正用得到這件事的商家大致落在 2 種情境。第一種是跨境賣家或外銷型電商,海外顧客本來就習慣用 PayPal 結帳,看到熟悉的付款按鈕才敢下單,換成一個他沒聽過的本地金流反而會提高棄單率。第二種是接國外案子的自由工作者、訂閱制或數位服務商,客戶散布在不同國家,PayPal 幾乎是這類跨境交易的共同語言,不需要顧客先確認這個網站能不能收他的信用卡。如果商店經營的是純內銷、顧客幾乎都在台灣,串接 PayPal 能帶來的實際效益有限,但了解串接的原理與設定方式,對日後想擴大到海外市場仍有幫助。
PayPal 商業帳戶的申請資格、必備資料與銀行連結
裝外掛、跑連接精靈之前,還有一步經常被忽略,先把 PayPal 帳戶本身申請好。這一步跟後面的外掛設定是分開的兩件事,帳戶審核需要時間,建議先送出申請,等帳戶到位後再回頭處理串接。
PayPal 的個人帳戶只適合私人收付款,拿來做網站收款會綁手綁腳,商業帳戶才是網站收款該用的類型,能設定公司資訊,也能授權多達 200 名員工存取同一個帳戶,還能替客服信箱設定別名,方便團隊分工管理而不必共用同一組登入密碼。

申請商業帳戶要準備的資料不算複雜:法定全名、電子郵件地址、密碼、商業登記號碼、業務說明,以及商業銀行帳戶詳細資料。整個流程是先完成註冊,接著填寫個人與企業資訊,再連結銀行帳戶,最後完成身分驗證即可開始收款。PayPal 官方形容這套線上註冊流程「只需幾分鐘」就能完成。
帳戶申請完成之後,還有一個容易被忽略的前提,銀行帳戶要成功連結,之後才提領得出款項。PayPal 目前透過與玉山銀行合作的「玉山全球通」服務,讓台灣的使用者可以把 PayPal 帳戶裡主要貨幣的交易款項,提領到玉山銀行的新台幣或美元帳戶,玉山銀行處理提領大約需要 3 到 7 個工作天。這裡有一個容易忽略的細節,PayPal 帳戶登記的姓名必須與銀行帳戶姓名相符,而且要用同一種語言、同樣的字元,姓名對不上會直接卡在提領這一關,先把這件事確認好,免得帳戶申請完成,真的收到錢了才發現領不出來。
步驟一,安裝並啟用 WooCommerce PayPal Payments 外掛
商業帳戶到位之後,真正動手的第一步是選對外掛,這裡直接指定用 WooCommerce PayPal Payments,理由不是隨便挑一個。它是 PayPal 與 WooCommerce 官方共同維護的整合方案,舊版的 PayPal Standard,也就是早期靠 NVP-SOAP API 憑證串接的那條路,已經走進歷史。WooCommerce 官方部落格已經明確發布公告,宣布 PayPal Standard 不會再收到新功能、效能改善或長期支援,雖然沒有訂出強制關閉的確切日期,官方也表態沒有計畫在近期突然關閉,但明確建議商家盡快遷移到 PayPal Payments for WooCommerce。這篇從一開始就直接走現行的官方路徑,不教這條已經在淘汰的舊做法。
安裝前先確認環境符合需求,WordPress 版本 6.5 以上、WooCommerce 版本 9.6 以上、PHP 版本 7.4 以上,並且要有一個 PayPal 商業或個人帳戶,也就是上一節申請的那個帳戶。
確認需求都符合之後,到 WordPress 後台的外掛頁面,點選「安裝外掛」,在搜尋欄輸入「WooCommerce PayPal Payments」,找到官方外掛之後按下安裝、再啟用。啟用完成的當下,系統會自動跳出一個提示,把商家導向帳戶連接設定頁,後面整節連接精靈,就是接著這個提示往下走。

步驟二,連接精靈依序完成的五個設定關卡
安裝啟用後看到的連接精靈,是整個串接流程裡最核心的操作段落。這個精靈同時支援連接正式的 PayPal 帳戶,以及連接用來測試的沙盒帳戶,這一節先講正式帳戶會依序碰到的 5 個設定關卡,沙盒測試流程留到下一節專門講,先把正式串接的邏輯搞懂,測試環境跑起來才不會覺得莫名其妙。

一開始精靈會先問一句,要以商業身分還是個人身分連接。選商業帳戶,才能解鎖信用卡與金融卡付款處理、防詐機制,以及開立發票這類進階功能,官方也建議商家直接選商業帳戶,而不是為了圖方便選個人帳戶,個人帳戶能開的功能有限,之後想加開進階付款方式還要回頭重新設定。

選好身分之後,精靈接著會依商店銷售的商品類型客製化設定,這一步下一節細講;接下來讓商家加開想要的結帳功能,這一步再下一節細講。走完這 2 關,精靈會要求登入既有的 PayPal 帳戶,或依畫面指示建立新帳戶,如果前面已經申請好商業帳戶,這裡直接登入即可。最後按下「Connect to PayPal」完成連接,畫面就會回到 WooCommerce 後台的總覽頁,上面會看到一份接下來要做的待辦清單、目前已啟用的功能列表,以及說明中心的連結入口,代表帳戶已經正式連上,商店隨時能開始收款。
依商品類型客製化的串接設定
關卡二會問實際在賣的商品屬於哪一種類型,這一步的答案會直接影響後面很多設定的預設值,選錯類型,後面的付款流程可能整個對不上。
精靈提供的分類分成 3 種:虛擬商品或服務,以及包含預訂或訂金的商品,這類通常可以直接扣款,不用等出貨才請款;需要出貨的實體商品,通常會先保留授權,等出貨後才正式請款;訂閱型商品則另有考量,這個選項只有在商店已經啟用 WooCommerce Subscriptions 擴充功能時才會出現,單獨裝 PayPal Payments 並不會自動獲得訂閱收款的能力,這點容易被誤解,值得特別點出。挑選類型時就照商店實際在賣的東西選,不要為了想要某個特定功能而選錯類別,否則後面的付款意圖與出貨流程都會對不上實際的營運方式。

信用卡、數位錢包、Fastlane 與在地支付方式的結帳擴充選項
關卡三讓商家勾選要加開哪些結帳功能,官方列出 4 種,各自的用途不太一樣,不是全部打開才對,依商店實際賣的東西挑選需要的就好。
自訂信用卡欄位可以依商店的視覺風格調整樣式,同時內建 3D 驗證與拒付保護這兩層進階防詐機制,適合大多數想直接在自家結帳頁收卡片的商店;數位錢包涵蓋 Apple Pay 與 Google Pay,Google Pay 可以直接啟用,但 Apple Pay 需要先完成網域註冊才能正式上線,這道手續留到後面「進階結帳功能」那一節再細講;Fastlane 讓顧客只要輸入電子郵件,就能帶出先前儲存過的付款資訊,省去重新輸入卡號的步驟,對加速訪客結帳特別有幫助;Alternative Payment Methods 則依顧客所在市場,提供當地慣用的在地支付選項,實際會出現哪些方式,取決於顧客所在地區。舉例來說,純數位商品或訂閱制服務的商店,可能就不需要為了 Apple Pay 另外處理網域註冊這道手續,直接把資源放在信用卡欄位與 Fastlane 上就夠用。
步驟三,上線前用沙盒帳號完整測試一次金流
連接精靈跑完,商店技術上已經能收款,但真正開放給顧客付款之前,還有一個最容易被跳過、卻最該做的動作,先用假錢把整個下單到付款的流程完整跑一次。真實金錢交易一旦失敗,通常是第一筆訂單就進行不下去,顧客等著收到商品或服務,商家卻搞不清楚問題出在哪個環節,處理起來遠比事先測試麻煩得多。
要跑這套測試,得先準備沙盒帳號。做法是前往 developer.paypal.com,用現有的 PayPal 帳號登入,進入 Dashboard 裡的 Developer Dashboard,選擇 Sandbox Account,點選 Create Account,可以直接使用系統預先產生的商業帳號,也能自己建立一個新的商業或個人帳號。記下這組帳號的電子郵件與密碼,等一下連接精靈的流程會用到。除了這組扮演賣家的帳號,建議另外再建立第二組帳號,商業或個人都可以,拿來扮演測試下單的買家,如果賣家與買家共用同一個帳號,測試出來的付款流程並不真實。
回到 WooCommerce 的連接精靈,點選「See advanced options」就能看到啟用 Sandbox Mode 的選項。啟用之後,可以透過 PayPal 的 onboarding 流程連接沙盒帳戶,或者手動輸入既有的 PayPal REST 應用程式憑證,接著按下 Connect Account,把剛才建立的沙盒帳戶連進去。

沙盒帳戶連上之後,拿測試買家帳號在前台走一次完整的下單流程,加入購物車、結帳、用沙盒帳號付款,再回到 WooCommerce 後台確認訂單狀態有沒有正確變化。這整套流程可以完整測試,卻不會真的產生任何金錢往來,確認狀態沒問題,再把 Sandbox Mode 切回正式模式,商店就能開始收真正的款項。
步驟四,上線前必須確認的三個設定值
連接精靈跑完、沙盒測試也過關,不代表所有設定都已經到位。這裡有 3 個容易被忽略、卻會直接影響顧客付了錢、訂單卻沒有正確反應的設定值,逐一確認清楚,才算真的準備好上線。
第一個是發票前綴(Invoice Prefix)。如果同一組 PayPal 帳戶被多個商店共用,官方建議替每個商店設定一組唯一的前綴,例如 INV-,方便日後在 PayPal 帳戶裡追蹤某筆款項屬於哪一間商店的哪一筆訂單,避免多店共用時對不上帳。
第二個是付款意圖(Order Intent),這一項決定顧客按下付款的那一刻,錢是真的被扣走,還是先鎖住授權。Authorize Only 會先保留授權、不立即向顧客收款,等商家準備好出貨或提供服務,再手動請款,適合需要準備時間的實體商品或客製化服務;Capture Virtual-Only Orders 則是虛擬商品可以直接立即扣款,不用等到出貨這道手續。這個選項跟前面依商品類型客製化那一步選的類型是同一套邏輯的延伸,兩邊設定要對得起來,商店賣的東西才不會出現錢已經扣了卻還在等出貨授權這類矛盾。
第三個是 Webhook 訂閱狀態,這是訂單狀態能不能即時同步的關鍵。Webhook 負責把 PayPal 端的付款狀態更新,例如已核准、拒絕、已退款,即時傳回 WooCommerce 後台;設定頁面可以看到目前訂閱了哪些事件,也能用 Test Webhooks 功能模擬事件,驗證連線是否正常運作。同一個頁面還有 Enable Logging 這個選項,開啟之後會留下詳細記錄,串接出狀況時能拿來排查是哪個環節出了問題,這個功能在後面「金流串接異常」那一節還會再提到。
Smart 按鈕在各頁面的顯示位置與外觀都能自訂
連接帳號、確認完關鍵設定之後,顧客實際會看到的,是結帳頁面上那顆 PayPal 按鈕,這顆按鈕能出現在哪些頁面、長什麼樣子,都可以依商店的風格調整,不是只有官方預設的樣式一種選擇。
顯示位置一共有 5 個可以個別勾選:購物車頁面、傳統結帳頁、快速結帳、迷你購物車,以及商品頁本身,商家可以依動線需要,決定要在哪幾個頁面放上這顆按鈕。除了位置,還能挑選要顯示哪些付款方式的按鈕,PayPal、Venmo、Pay Later 都可以個別開關;外觀部分,形狀有預設的矩形與圓角的 Pill 兩種可選,按鈕上的文字預設是「Pay with PayPal」,也能換成「Buy Now」或「Pay Later」這類更貼近商店語氣的字樣,顏色預設是金色,同樣可以調整成貼近商店品牌的配色,設定畫面本身就提供即時預覽,調整完直接看得到結果,不用另外重新整理頁面。
外觀能自訂看起來像是選配的細節,實際上會影響顧客對這個付款方式熟不熟悉的第一印象,按鈕文字含糊或顏色跟商店整體風格格格不入,反而會讓顧客多想一下要不要點下去。把顯示位置、按鈕類型與外觀都依商店實際的顧客動線調整過一次,比全部沿用預設值更能讓這顆按鈕自然融入結帳流程。
手續費結構,串接前先把實際成本算清楚
PayPal 收手續費是常識,但實際費率結構怎麼算,很少人真的攤開來看過。跨境交易、幣別轉換各有一套算法,官方都公布了具體數字,算得出來,心裡才有底。
當付款人與收款人不是同一個市場的居民,也就是典型的跨境交易時,PayPal 收取的費率是 4.40% 加上一筆固定費用,固定費用依收到款項的幣別而不同:收到新台幣是 10 元、美元是 0.3 元、歐元是 0.35 元、英鎊是 0.2 元。這筆固定費用金額不大,但跨境交易本來就是這篇鎖定的主要情境,累積起來仍是實際成本的一部分,做定價或抓利潤時該一併算進去。
除了跨境交易本身的費率,幣別轉換還會另外收一筆手續費,而且依情境不同分成 3 種費率:標準的付款或退款貨幣轉換,收取基礎匯率再加 4.00%;提領到銀行帳戶時的貨幣轉換,收取基礎匯率加 2.50%;其他情境的貨幣轉換,則是基礎匯率加 3.00%。換句話說,商家收到的是美元,要提領成新台幣進自己的銀行帳戶,實際拿到手的金額,是先扣掉跨境交易費率,再扣掉提領時的貨幣轉換費率,兩層費用疊加,不是單看一個數字就能推算出淨收入。

提領這一段前面已經提過,台灣的使用者透過與玉山銀行合作的玉山全球通服務,把 PayPal 帳戶裡的交易款項領到玉山銀行的新台幣或美元帳戶,銀行處理大約需要 3 到 7 個工作天,而且 PayPal 帳戶登記的姓名要跟銀行帳戶姓名相符、同語言同字元,才能順利領出款項。這件事在申請帳戶的階段就該一次確認好,別等到真的收到款項才卡在提領這一關。

PayPal 付款狀態會對應到特定的 WooCommerce 訂單狀態
串接完成、開始實際收款之後,商家最常遇到的問題往往是,顧客說他已經付了錢,後台看到的訂單狀態卻怪怪的。這種落差多半不是系統壞掉,而是付款意圖與 Webhook 這兩件事沒對上,弄懂對應關係,大部分狀況都能自己判斷出問題出在哪。
前面「步驟四」設定的 Order Intent,直接決定訂單狀態怎麼變化。選擇 Authorize Only 時,顧客結帳當下,付款只是先被授權、保留住,並沒有立即入帳,要等商家準備好出貨或提供服務,手動請款之後,訂單才會真正轉為已扣款;選擇 Capture,包含只針對虛擬商品的 Capture Virtual-Only Orders,顧客完成結帳的那一刻,款項就直接入帳,訂單狀態也會跟著同步更新。
負責把這些狀態即時同步回 WooCommerce 的,是前面提到的 Webhook 訂閱,PayPal 那端一有付款核准、拒絕或退款這類狀態更新,都是靠 Webhook 即時傳回商店後台。如果 Webhook 訂閱沒有正常運作,訂單容易卡在等待付款這個狀態,不會自動轉成處理中或已完成,顧客那邊看到的可能是已經扣款成功,商家後台卻還顯示訂單未完成,兩邊資訊對不上,這時候該回頭檢查的正是 Webhook 的連線狀態,而不是懷疑款項本身有問題。
退款的部分不需要另外登入 PayPal 後台處理,商家可以直接在 WooCommerce 的訂單頁面執行退款,系統會把退款請求同步送回 PayPal 那一端完成,這一點對日常客服處理退換貨特別方便,不用在兩個系統之間來回切換。
金流串接異常時,優先排查的三個環節
串接完 PayPal,偶爾還是會遇到付款進行不下去、訂單狀態不對這類異常。與其第一時間聯絡客服等待回覆,不如先照順序排查 3 個最常出狀況的環節,多半當場就能找出問題出在哪裡。
第一個要排查的是沙盒模式與正式模式有沒有不小心混用。Sandbox Mode 與正式帳戶連線是兩組完全獨立的憑證,如果商店已經連接正式帳戶,卻又在設定頁誤觸或切換了 Sandbox 選項,系統實際使用的會是另一組憑證,付款自然對不上,遇到異常時,先確認目前連接的是哪一組帳戶,是最快能排除的可能性。
第二個環節是 Webhook 與伺服器對外連線的狀態。Webhook 需要伺服器能用 HTTPS 正常對外通訊,才能接收 PayPal 傳回的付款狀態更新;如果對外連線埠被防火牆擋住,或者網站本身沒有正確的 HTTPS 憑證,Webhook 的通知就傳不進來。設定頁面的 Test Webhooks 功能可以模擬事件、驗證連線是否正常,遇到問題也可以開啟 Enable Logging 留下詳細記錄,用來判斷卡在哪個環節。
第三個容易被忽略的環節,是快取外掛或本地端環境造成的干擾。如果測試是在 localhost 這種本機環境進行,PayPal 的伺服器天生無法從外部連進來,Webhook 通知自然也就收不到,這不是設定錯誤,而是本機環境本身的限制。測試務必在有對外網址的正式站或測試站環境進行,才能正確判斷串接是否真的成功,不要拿本機環境的結果當作最終依據。
Apple Pay、Google Pay 和 Pay Later 三項進階結帳功能
前面把帳號連上、關鍵設定確認完,結帳流程已經能正常運作。串接 PayPal Payments 之後,其實還能再往上疊加幾項會直接影響轉換率的進階功能,設定完金流不代表就此打住。
第一項是 Apple Pay。這項功能不是勾選就能立刻上線,WooCommerce 後台總覽頁的待辦清單裡,會列出「Register Domain for Apple Pay」這一步,需要先完成網域註冊,Apple Pay 才會正式出現在結帳頁面上,這道手續在前面「結帳擴充選項」那一節已經提過,這裡是實際會用到它的地方。
第二項是 Google Pay,門檻明顯低得多。在付款方式設定頁面直接啟用即可,不需要額外的驗證程序,對想快速加開更多結帳選項的商店來說,是投入產出比最高的一項。
第三項是 Pay Later 分期付款訊息,會在商品頁或購物車顯示可以分期付款的動態提示。PayPal 公布的統計指出,Pay Later 能提升商家的轉換率,並讓客單價增加 39%,這個數字出自 PayPal 2021 年第二季財報。這裡要誠實交代,這是 PayPal 自己公布的數據,實際成效會因商店類型、客群與商品單價不同而有落差,不是裝上去就保證看到同樣的漲幅,但作為一項幾乎不需要額外成本就能加開的功能,值得放進優化的考慮清單裡。
串接 PayPal 這件事,拆開來看每一步都不難,真正決定成敗的是順序。先申請好商業帳戶,再走連接精靈,拿沙盒帳號跑過一次完整流程,確認發票前綴、付款意圖與 Webhook 這 3 個設定值,才把商店真正打開給顧客付款。少了沙盒測試這一步,等到第一筆真實訂單出狀況才發現設定有問題,處理起來遠比事先花點時間測試麻煩得多。
手續費與提領天數是另一件該先算清楚的事,跨境交易的費率、貨幣轉換的 3 種情境、玉山全球通的處理天數,這些數字加總起來,才是這條收款路徑真正的成本。設定到位之後,WooCommerce PayPal 串接能帶來的其實是一種讓海外顧客安心付款的熟悉感,顧客不用先問這個網站能不能收他的錢就直接結帳,這正是跨境賣家與接海外案子的工作者,最先感受到差異的地方。
