前置條件
建立定期付款前，請先在 儲存付款方式 完成以下步驟：- 建立顧客資料並保存
customer_id。 - 透過 Element SDK 產生付款 Token。
- 從付款 Token 通知確認並保存
token_id。
扣款流程說明
儲存付款方式與訂閱為兩個獨立的記錄：- 儲存付款方式包含可重複使用的
customer_id與token_id。 - 訂閱定義產品、扣款週期及生命週期。
整合步驟
步驟 1：建立 Product
定義訂閱產品及扣款週期。 POST/product/v1/create
product_id。
步驟 2：建立 Subscription
使用已儲存的顧客、Token 與訂閱產品建立 Subscription。 POST/subscription/v1/create
subscription_id 及目前狀態。
步驟 3：處理訂閱通知
請整合訂閱支付 Webhook，接收訂閱狀態變更及定期扣款結果。付款 Token 通知獨立於訂閱流程，請參閱付款 Token 通知。
測試
請在 Sandbox 完整測試流程：建立儲存付款方式、確認 Token 通知、建立產品、建立訂閱，並驗證 Webhook 處理。最佳實踐
- 以冪等方式驗證及處理 Webhook。
- 在後端保存
customer_id、token_id、product_id及subscription_id。 - 依您的重試政策處理扣款失敗與顧客通知。
- 上線前測試取消訂閱、替換 Token 及扣款失敗的情境。