> ## Documentation Index
> Fetch the complete documentation index at: https://sdk.qfapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 付款 Token 通知

> 處理確認付款 Token 已建立的非同步通知。

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

## 設定通知 URL

<Note>
  如需啟用付款 Token 通知，請將通知 URL、商戶 ID 及門店 ID 電郵至 [technical.support@qfpay.com](mailto:technical.support@qfpay.com)。
</Note>

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

## 通知欄位

| 欄位                  | 說明                          |
| ------------------- | --------------------------- |
| `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 參考編號。              |

## 範例

```json theme={null}
{
  "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。

## 下一步

在 [定期付款](/zh-hant/integration/online-shop/integration-by-use-case/recurring-payments/recurring-overview) 或其他支援的後續付款流程中，使用已確認的 `customer_id` 與 `token_id`。