Recur Docs

Customer Portal 讓顧客自行管理訂閱,減少客服負擔,提升顧客滿意度。

功能特點

訂閱管理

顧客可以:

  • 查看目前訂閱狀態
  • 查看下次扣款日期與金額
  • 升級或降級方案
  • 取消訂閱

付款方式

  • 查看目前付款方式
  • 更新信用卡資訊
  • 新增備用付款方式

帳單歷史

  • 查看所有歷史帳單
  • 下載收據 PDF
  • 設定發票資料

開啟 Portal

有三種方式讓顧客存取 Portal:

方式一:Portal 連結

產生一次性 Portal Session,導向顧客到 Portal:

const response = await fetch('https://api.recur.tw/v1/portal/sessions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_test_xxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    customerId: 'cus_xxx',
    returnUrl: 'https://your-site.com/account',
  }),
});

const { url } = await response.json();

// 導向 Portal
window.location.href = url;

方式二:嵌入式 Portal

使用 SDK 在您的網站內嵌入 Portal:

<script src="https://unpkg.com/recur-tw@latest/dist/recur.umd.js"></script>
<recur-portal
  publishable-key="pk_test_xxx"
  customer-id="cus_xxx"
></recur-portal>

方式三:顧客自助登入

不需要自己的會員系統:顧客到您的商店頁面登入,再自行進入 Portal。

  1. 前往「設定」→「客戶入口設定」,開啟「客戶自助登入」(預設關閉)
  2. 把顧客導到 https://{您的商店代稱}.recur.tw/login(或您已驗證的自訂網域)
  3. 顧客輸入訂閱時使用的 email,點擊信中的登入連結
  4. 登入後在「我的帳號」點選「管理訂閱與付款方式」,即進入 Portal

開啟前請留意:這個方式以 email 信箱作為身分依據,能收到該信箱信件的人就能管理這位顧客的訂閱與付款方式。透過 API 建立顧客時,請確認您提供的 email 正確。

登入連結 1 小時內有效、只能使用一次,且只能在發出它的商店使用。

後台設定

Portal 功能開關

  1. 前往「設定」→「Portal 設定」
  2. 選擇開放的功能:
    • 允許取消訂閱
    • 允許方案變更
    • 允許更新付款方式
  3. 儲存設定

品牌自訂

  • 上傳 Logo
  • 設定主題色
  • 自訂文字內容

安全性

  • Portal Session 建立後 1 小時過期,過期後需重新產生
  • 每位顧客最多同時保有 5 個有效 Session,超過時最舊的會失效
  • Session 網址即為存取憑證,請勿公開分享

詳細整合教程請參考 Portal 整合指南。

Last updated on