訂閱支付整合指南
前置條件
開始整合前，請確認以下事項：
- 您已擁有 API 認證憑證（
AppCode、AppKey）。 - 您已設定 Notify URL，用於接收 QFPay 傳送的非同步 Webhook 通知。
- 前端已具備整合與渲染 Payment Element 的能力。
整合流程總覽
整個訂閱支付的整合流程包含以下步驟：
- 設定 Webhook 接收端，可接收
payment_token、subscription與subscription_payment通知。 - 建立 Customer 物件 並取得
customer_id。 - 在前端渲染 Payment Element，使用
payment.pay()搭配customer_id來建立付款 token。 - 透過 Webhook 通知或 API 回應 捕捉
token_id。 - 建立 Product 物件，定義每期金額、週期頻率與間隔。
- 建立 Subscription 訂閱計劃，傳入
customer_id、token_id與product_id。 - （選用）透過 webhook 或 查詢 API 監控訂閱狀態。
最佳實踐
備註
請使用 查詢 API同步訂閱狀態到 CRM 系統。
提示
每次建立訂閱後，請確認收到 webhook，狀態為 ACTIVE 或 INCOMPLETE，以確認建立成功。
注意
請務必在資料庫中儲存 subscription_id 與 token_id，以便後續追蹤、補扣款、取消或報表用途。