- 訂閱狀態變更
- 定期扣款結果
付款 Token 通知獨立於訂閱流程,請參閱付款 Token 通知。
如何設定 Webhook URL
如需設定 Webhook 接收端點,請將 Webhook URL、商戶 ID 及門店 ID 提供給 technical.support@qfpay.com。
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
說明 QFPay 訂閱支付的 Webhook 非同步通知機制,包括 Token 建立、訂閱狀態變更與定期扣款結果。
| 欄位 | 說明 |
|---|---|
notify_type | 固定為 subscription。 |
subscription_id | 訂閱 ID。 |
state | 訂閱狀態,例如 ACTIVE、COMPLETED 或 INCOMPLETE。 |
sysdtm | 系統時間。 |
{
"state": "COMPLETED",
"sysdtm": "2024-04-24 15:19:39",
"notify_type": "subscription",
"subscription_id": "sub_e51bb914919*****f6b0fe36d"
}
| 欄位 | 說明 |
|---|---|
notify_type | 固定為 subscription_payment。 |
subscription_id | 訂閱 ID。 |
subscription_order_id | 格式為 sub_ord_{subscription_id}_{0001}。 |
respcd | 回應碼;0000 表示成功。 |
respmsg | 回應訊息。 |
syssn | 系統交易流水號。 |
txdtm | 交易時間。 |
txamt | 交易金額。 |
txcurrcd | 交易幣別。 |
customer_id | 顧客 ID。 |
product_id | Product ID。 |
cardcd | 遮罩後的卡號。 |
card_scheme | 卡組織(如有)。 |
current_iteration | 扣款期數。 |
{
"txcurrcd": "HKD",
"reason": "AUTHORISED",
"subscription_order_id": "sub_ord_a360f06eb*****ad6aff24c3a",
"product_id": "prod_8c838c17ddb043b9***11f1a85c30",
"txdtm": "2024-04-24 15:19:37",
"txamt": "300",
"card_scheme": "VISA_DEBIT-SSL",
"syssn": "20240424180500020000015704",
"respcd": "0000",
"subscription_id": "sub_e51bb914919***31d800f6b0fe36d",
"customer_id": "cust_a9c0bcf2717f4***786a10e5f8f2",
"notify_type": "subscription_payment",
"current_iteration": "1"
}
這個頁面有幫助嗎?
