付款 Token 通知 - QFPay Developer Centre

QFPay 在透過 Element SDK 建立付款 Token 後，會發送「付款 Token 通知」。請以此通知作為 token_id 可供後續使用的最終確認依據。

設定通知 URL

如需啟用付款 Token 通知，請將通知 URL、商戶 ID 及門店 ID 電郵至 technical.support@qfpay.com。

付款 Token 通知使用專用的通知端點，與標準付款通知端點不同。

通知欄位

欄位	說明
`userid`	QFPay 門店 ID。
`notify_type`	通知類型：`payment_token`。
`event`	`NEW`、`MATCH` 或 `CONFLICT`。
`tokenid`	建立完成的付款 Token ID。
`token_expiry_date`	Token 到期時間。
`cardcd`	遮罩後的卡號。
`card_scheme`	卡組織，例如 VISA 或 MASTERCARD。
`respcd`	回應碼；`0000` 表示成功。
`respmsg`	回應訊息。
`sysdtm`	系統時間。
`customer_id`	關聯的顧客 ID（如有）。
`token_reason`	Token 化原因。
`token_reference`	商戶 Token 參考編號。

範例

{
  "respmsg": "success",
  "card_scheme": "ECMC_DEBIT",
  "cardcd": "5200****1096",
  "tokenid": "tk_6a699aae75094caeb066f****988daa32de",
  "respcd": "0000",
  "token_expiry_date": "2024-04-30 00:00:00",
  "sysdtm": "2024-04-29 15:37:17",
  "notify_type": "payment_token",
  "event": "CONFLICT"
}

處理建議

依照 QFPay 整合要求驗證通知。
僅在成功通知後保存 tokenid。
以冪等方式處理通知，避免重複推送造成重複紀錄。
處理成功後回傳 HTTP 200。

下一步

在定期付款或其他支援的後續付款流程中，使用已確認的 customer_id 與 token_id。