內容目錄
WordPress 美安 API 串接教學:WooCommerce 美安分潤系統完整設定
美安 SHOP.COM 是台灣電商圈裡一個比較特別的通路。它不是一般的電商平台,而是一個結合直銷模式的購物回饋系統。如果你的電商網站能串接美安 API,等於多了一個銷售管道——美安的會員在你的網站消費,美安幫你導流,你按比例回饋分潤金。
聽起來不錯,但串接過程有點門檻。這不像綠界或藍新有現成外掛可以裝,美安 API 串接通常需要一定程度的客製化開發。我們做過好幾個美安串接案例,這篇把流程和注意事項都整理出來。
重點摘要: WordPress 美安 API 串接是把你的電商接入美安 SHOP.COM 的購物回饋系統。串接完成後,美安會員透過 SHOP.COM 連結到你的網站消費,你依比例回饋分潤金。串接需要美安合作帳號和 API 文件,流程比一般金流複雜,建議找有經驗的團隊協助。
💡 美安串接有問題?加 LINE 免費諮詢,我們有豐富的美安 API 串接經驗。 👉 加 LINE 免費諮詢
美安 SHOP.COM 串接是什麼?為什麼電商要做
你可能會問:為什麼要多此一舉串接美安?
原因很簡單——流量。美安在台灣有龐大的會員網絡,這些會員有消費需求,而且習慣透過 SHOP.COM 購物來獲取回饋點數。如果你的商品出現在 SHOP.COM 上,等於免費多了一個導流管道。根據 GlobeNewsWire 報告,台灣 B2C 電商市場 2025 年達 209.7 億美元(GlobeNewsWire, 2026),在這個龐大市場中多一個導流管道的價值很高。根據 W3Techs 數據,WordPress 驅動全球約 42.5% 的網站(W3Techs, 2026),WooCommerce 佔全球電商約 33.4% 市佔率(Red Stag Fulfillment, 2025)。根據 tenten 報告,台灣行動購物佔電商交易量已達 60%(tenten, 2025),美安會員也大量透過手機瀏覽 SHOP.COM。根據金管會統計,2025 年底台灣電子支付使用人數達 3,765 萬(經濟日報, 2025),金流整合的完整度影響美安會員在你網站的購買體驗。根據 DebugBear 報告,網站載入每延遲 1 秒轉換率下降 12%(DebugBear, 2025),從 SHOP.COM 跳轉到你網站的載入速度會影響轉換。
美安分潤系統運作原理
- 美安會員在 SHOP.COM 上搜尋商品
- 看到你的商品後,點擊連結跳轉到你的電商網站
- 在你的網站上完成消費
- 你的網站透過 API 把訂單資料回傳給美安
- 美安根據訂單金額計算分潤,你回饋一定比例的傭金
串接美安對電商的好處
- 增加曝光:你的商品出現在 SHOP.COM 的搜尋結果中
- 免費導流:美安會員主動到你的網站消費,不用花廣告費
- 額外營收:雖然要回饋分潤,但這些訂單本來就是額外的
但也有個缺點。分潤比例會壓縮你的利潤,所以要先算好你的毛利率夠不夠。通常分潤比例在 2-5% 之間,如果你的毛利率低於 20%,要慎重考慮。
串接前準備工作
美安 API 串接不像裝個外掛那麼簡單。你需要先準備幾件事。
美安合作帳號申請流程
- 聯繫美安 SHOP.COM 的合作夥伴計畫
- 提交你的電商網站資訊和商品清單
- 美安審核通過後,會提供你 API 文件和測試環境資訊
這個申請流程比一般金流長,通常需要 2-4 週。
API 文件與技術規格確認
美安會提供一份 API 技術文件,裡面包含:
- API 端點(Endpoint)
- 驗證方式(通常是 API Key + Secret)
- 訂單回傳格式(JSON 或 XML)
- 分潤追蹤碼的嵌入規則
這份文件需要有技術背景的人來看。如果你看不懂沒關係,我們可以幫你處理。
WooCommerce 環境需求
- WordPress 5.0 以上
- WooCommerce 5.0 以上
- PHP 7.4 以上
- HTTPS(SSL 必須)
美安串接跟一般金流最大的差別在於:它不是標準化的外掛安裝流程,而是需要根據你的電商業態做客製化開發。這也是為什麼市面上幾乎找不到「一鍵串接美安」的解決方案。
WordPress 美安 API 串接步驟
美安目前沒有現成的 WordPress 外掛可以一鍵安裝。串接方式通常有兩種:找有經驗的開發者客製化,或是用通用型的 API 整合外掛搭配手動設定。
安裝串接方案
- 客製化開發:依美安 API 文件開發專用外掛,彈性最大,穩定性最好
- 通用 API 外掛:用 WooCommerce 的 webhook 或第三方 API 外掛來對接
我們比較推薦客製化開發。雖然前期成本高一點,但之後維護和除錯都比較容易。
API 端點設定
根據美安提供的 API 文件,設定:
- API 端點 URL
- API Key 和 Secret
- 回傳格式(通常是 JSON)
訂單資料回傳格式設定
這是串接的核心。當消費者在你的網站完成訂單後,你的系統需要自動把訂單資料發送給美安的 API。回傳的資料通常包含:
- 訂單編號
- 商品名稱和數量
- 訂單金額
- 消費者的美安追蹤碼
分潤追蹤碼嵌入
美安會員來到你的網站時,URL 裡會帶有一個追蹤碼(tracking code)。你的網站需要:
- 抓取 URL 中的追蹤碼
- 存入 session 或 cookie
- 消費者下單時,把追蹤碼一起回傳給美安 追蹤碼的存取是最容易出問題的地方。如果你的網站有裝快取外掛(如 WP Rocket、W3 Total Cache),可能會導致追蹤碼被快取覆蓋。我們有個客戶就因為這個問題,美安那邊顯示的訂單數比實際少了 30%。解法是把帶追蹤碼的頁面排除在快取之外。
學完覺得太複雜?沒關係,加 LINE 讓我們幫你搞定
美安 API 串接涉及客製化開發和技術細節。我們有豐富的美安串接經驗,可以幫你從頭到尾處理。
測試與驗證
串接完成後,一定要做完整的測試。
測試環境模擬下單
美安通常會提供測試環境。在測試環境中:
- 模擬美安會員點擊連結進入你的網站
- 確認追蹤碼有正確被抓取
- 完成一筆測試訂單
- 確認訂單資料有正確回傳給美安的 API
分潤追蹤驗證
測試訂單回傳後,在美安的後台確認:
- 訂單資料正確(金額、商品)
- 追蹤碼正確(對應到正確的美安會員)
- 分潤金額計算正確
正式上線前確認清單
- 追蹤碼抓取正常
- 訂單回傳正常
- 分潤計算正確
- 快取外掛排除設定
- 錯誤處理機制(API 連線失敗時的備案)
常見問題排解
API 連線逾時處理
美安的 API 回應有時會比較慢。如果你的網站設定的 timeout 太短,可能會出現連線逾時的錯誤。建議把 API 請求的 timeout 設為 30 秒以上。
分潤計算不正確
確認以下幾點:
- 回傳的訂單金額是否含稅/未稅(跟美安確認用哪個)
- 退貨訂單有沒有同步回傳
- 追蹤碼是否正確對應
訂單同步問題
如果你的 WooCommerce 訂單狀態改變了(如取消、退款),記得也要同步通知美安的 API。不然美安那邊會出現已取消的訂單還在算分潤的情況。
常見問題 FAQ
Q: 美安串接一定要找工程師嗎?
A: 基本上是的。美安沒有現成的 WordPress 外掛,串接需要客製化開發或至少有 API 串接經驗。如果你自己沒有技術背景,找有經驗的團隊協助會快很多,也比較不容易出問題。
Q: 美安串接的費用大概多少?
A: 依複雜度而定。如果是標準的訂單回傳和追蹤碼功能,客製化開發大約 NT$10,000-30,000。包含後續維護的話費用會再高一些。加 LINE 跟我們聊聊你的需求,我們可以給你更精確的報價。
Q: 串接美安會影響網站速度嗎?
A: 正常情況不會。API 回傳是在訂單完成後的背景作業,不會影響消費者端的瀏覽體驗。但如果追蹤碼的抓取方式做得不好(如用同步請求而不是非同步),可能會稍微影響頁面載入速度。
延伸閱讀
美安串接有問題?LINE 我幫你解決
美安 API 串接是我們的強項之一。從帳號申請、API 開發到測試上線,GOT YOU DESIGN 全程協助。
如果你願意,我們陪你一步一步來
先加入 LINE 跟我們聊聊你的狀況,我們會給你適合的建議;也可以直接看看線上課程內容,選擇最適合自己的節奏。

