說明
登入

為 Shop Cash 準備好您的系統

在您依賴 Shop Cash 進行出貨作業、會計、對帳或退貨工作流程之前，請確認每個接收訂單、付款、支付款項、退款或退貨資料的系統都能正確處理 Shop Cash。

Shop Cash 是一種付款方式。這不是折扣、禮品卡或商店抵用金。如果系統預設每筆訂單只有一種付款方式、一筆訂單對應一列支付款項，或是採用較短的授權值，則在您大規模處理 Shop Cash 訂單前，系統可能需要進行更新。

此頁面包含

整合整備度檢查清單

在您透過第三方系統啟動 Shop Cash 工作流程前，請確認下列需求：

  • 您的企業資源規劃 (Enterprise Resource Planning, ERP)、OMS、出貨作業、會計及退貨系統能夠在單筆訂單中接受超過一種付款方式。
  • 在可提供閘道值的情況下，將 shop_cash 對應為一種付款方式。
  • 系統未將 Shop Cash 視為折扣、禮品卡或商店抵用金。
  • 授權值儲存為至少 1024 個字元的不透明變數長度字串。如果可以，請使用無限制的文字欄位。
  • 請款、失效與退款是透過交易 ID 而非授權值來識別。Admin API 請款與失效作業使用 parentTransactionId，而退款作業則使用 parentId。
  • 您的系統未解析、解碼、標準化、雜湊或截斷 Shop Cash 授權值。
  • 您的系統可以處理分組支付款項，其中單一 shop_cash_credit 列可代表多筆訂單。
  • 您的對帳工作流程不會將一筆訂單預設為等同一列支付款項。
  • 您的對帳工作流程可以處理在不同支付款項中結算的 Shop Cash 部分，以及卡片或 Shop Pay 分期付款部分。
  • 您的退款工作流程可以處理跨卡片或 Shop Pay 分期付款以及 Shop Cash 的部分退款。
  • 退款應用程式可以對 Shop Cash 請款交易進行退款，而不是對授權交易。
  • 若您在 2026 年 1 月之前曾執行過 Shop Campaigns，您的財務工作流程便會將歷史的 shop_cash_campaign_billing_debit 和相關行銷活動帳單列與訂單營收分開處理。自 2026 年 1 月起，行銷活動成本將改為計入您的 Shopify 帳單。

測試選項與限制

由於 Shop Cash 仰賴 Shop 買家帳號、Shop Cash 餘額、Shopify Payments 和 Shop Cash 結算基礎架構，因此 Shop Cash 測試有所限制。

驗證企業端對端整合最可靠的方法，是透過 Shop 建立低金額的正式訂單，然後再進行退款。此作法會建立類似正式環境的訂單交易、請款資料、支付款項活動、退款交易及退款扣款活動，這些資料會流經 Shopify 管理介面、Admin API 資料、支付款項匯出資料和支付款項 API 資料。

開發商店可協助驗證部分 API 欄位形式及對應邏輯，但無法可靠地執行由 Shop 啟動的完整結帳頁面、買家餘額及結算流程。測試模式及 Bogus 閘道不會建立類似正式環境的 Shop Cash 支付款項列，因為它們未採用即時的 Shopify Payments 結算流程。

您可自行測試的項目

您通常可以透過由 Shop 啟動的低金額正式訂單來測試下列工作流程：

  • 包含 Shop Cash 以及 Shop Pay 或 Shop Pay 分期付款之多重付款方式訂單的訂單擷取作業。
  • shop_cash 的 ERP 或 OMS 對應作業。
  • 完整 Shop Cash 授權值的儲存作業。
  • 針對該訂單的全額與部分退款。
  • shop_cash_refund_debit 支付款項活動擷取作業。
  • Shop Cash 抵用金的支付款項對帳作業。
  • 預購或在出貨作業時請款的行為 (若您的商店採用延遲請款)。
  • 退貨應用程式對具備多種付款方式之訂單的處理作業。

在正式環境中進行測試時，請使用低金額訂單，並遵循您商店的內部測試訂單與退款程序。

可能需要聯絡 Shopify 支援服務的項目

如果您在下列任何情境需要協助，請聯絡 Shopify 支援服務：

  • 檢閱正在推出 Shop Cash 服務之市場的 Shop Cash 可用性。
  • 調查失敗的 Shop Cash 請款或退款作業。
  • 在您的正常支付款項週期再加上額外一個支付款項週期過後，調查遺失的 Shop Cash 支付款項交易。
  • 檢閱是否可對已失效或過期的 Shop Cash 重新進行授權。
  • 規劃複雜的 ERP、OMS、預購或出貨工作流程上線作業。

在您拓展 Shop Cash 訂單量規模前，請完成下列檢查：

  • ERP 與 OMS 付款方式對應已針對 shop_cash 進行部署及驗證。
  • 已對一筆 Shop Cash 範例訂單擷取端對端資料，包含授權及請款交易。
  • 已對一筆 Shop Cash 支付抵用金範例進行與來源訂單的對帳作業。
  • 已處理一筆 Shop Cash 退款範例並與退款扣款進行對帳。
  • 支援分組 Shop Cash 支付款項列，或具備手動對帳流程。
  • 您的支援及財務團隊已瞭解部分退款的分配方式。
  • 預購、手動請款以及在出貨作業時請款的行為皆已驗證 (如適用)。
  • 退貨應用程式可識別並針對正確的 Shop Cash 請款交易進行退款。
  • 支援及財務團隊瞭解顧客 Shop Cash 餘額、Shop 優惠，以及 Shop Campaigns 帳單活動之間的差異。

關於 API 與訂單資料需求，請參閱「Shop Cash 訂單資料與第三方整合」。關於支付款項需求，請參閱「Shop Cash 支付款項對帳」。