> For the complete documentation index, see [llms.txt](https://apidoc.tokenpay.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.tokenpay.me/zh-hk/dai-fu/hui-diao-tong-zhi.md).

# 回調通知

{% hint style="info" %}
提示 (TIP)

代付完成後，系統會將相關的代付結果與資訊發送給商戶，商戶需要接收並返回響應。在與後台通知交互時，如果系統收到商戶響應不成功或超時，系統會認為通知失敗。通知將根據一定策略定期重新發起，以最大限度提高通知的成功率，但無法保證通知一定會成功。（通知頻率為 0s/15s/30s/3m/10m/20m/30m/60m/3h/6h）
{% endhint %}

{% hint style="warning" %}
警告 (WARNING)

注意：相同的通知可能會被多次發送到商戶系統。商戶系統必須能夠正確處理重複的通知。建議的做法如下：處理通知時，首先檢查代付的狀態，以判斷該通知是否已被處理。如果未處理，則進行處理。如果已處理，則直接返回成功結果。在狀態檢查和處理業務數據之前，請使用數據鎖進行並發控制，以避免函數重入造成的數據混亂。
{% endhint %}

{% hint style="danger" %}
危險 (DANGER)

商戶必須對代付回調的內容進行簽名驗證，並檢查返回的代付金額是否正確，以防止數據洩露和「虛假通知」的出現，從而造成資金損失。
{% endhint %}

### **POST**

{% code fullWidth="false" %}

```
「創建代付」提交的 notify_url 參數。如果該連結無法訪問，您的商戶將無法接收來自系統的通知。
```

{% endcode %}

#### 請求體 (Request Body)

| 參數名稱             | 類型     | 描述                                                                                                                                  | 說明 |
| ---------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------- | -- |
| app\_id          | string | 應用程式                                                                                                                                |    |
| mch\_id          | string | 商戶                                                                                                                                  |    |
| create\_time     | time   | 通知時間                                                                                                                                |    |
| resource\_type   | string | 通知的資源資料類型。支付成功通知為 encrypt-resource                                                                                                  |    |
| event\_type      | string | 通知類型。支付成功通知的類型為 PAYPAYOUT.SUCCESS。                                                                                                  |    |
| resource         | object | 通知資源資料                                                                                                                              |    |
| » original\_type | string | 原始回調類型為 payout                                                                                                                      |    |
| » algorithm      | string | 加密結果資料的加密演算法，目前僅支援 AES-256-ECB                                                                                                      |    |
| » ciphertext     | string | Base64 編碼的開/關結果資料密文。如果啟用，則返回加密內容。解密後，它是 [PayoutTransactionDetail](/zh-hk/shuo-ming/zi-liao-jie-gou.md#dai-fu-xiang-qing) 的 json 字串。 |    |
| » nonce          | string | 使用隨機字串加密                                                                                                                            |    |

### **請求示例 (Request example)**

```json
{
	"app_id": "xxxxx",
	"mch_id": "zzzzzz",
	"create_time": "2023-06-26T17:21:17.754429+08:00",
	"resource_type": "encrypt-resource",
	"event_type": "PAYPAYOUT.SUCCESS",
	"resource": {
		"original_type": "payout",
		"algorithm": "AEAD_AES_256_GCM",
		"ciphertext": "I/psKgdkVwxbkEIWtwRxfxLzViuRS+gJTQSdLf+lmK7awoqUcIJisTAJx0Qbv4K6wV8WgyMRFYHD5CCLKmFNU2OnmEm2f2vGhaoS2h28A9BEGx1CWEUw3tfldf/+VWlBAnIBylFjHzbSo7fgn7S3fFEAZHTxoy+9jNIoynqHZbn4Y6eucj1YCw0ZmuKHPpPPrvclbhHmaZHfau+SKyag3C0/cj7zu4mBkRZ39zuk9B7DAADzaRENOZ/ZyibU+zs3gibnCbI2NWEnQWIiCi7vK0jq/FCBWytHihQM364zlVrPPCBDbv2MSqk4fyAM7IDeT6h/z/2kmDOQ6aFPYlLojIkgCCOIevQITS9E+BS1rgmmH+DRKsJNiD257aLhX2/F53VEnjfqqKdDs2lqfX0dCMLqselGUT981fFKceXg+r6hQqcUzLlF28XL5NrfVPreRDo6jI2K0tCy9cOx+cxH3yoDzOFBzM0RlxWqvUhRsMv9ZGfpgCZ0o9HxNObqLjVCQzE5SWPXvmkw+QpWk0oNUvpCEDhj9Vfq6XCV8j3tT3tZTYCa5UQy9VCdmval/2vb50QaAgDYXU6PH/9Xv7AXg6kg29iK+Ec0euxZxosRoVczzRg+0Arl/zvBcphWNIUTdx5IcA12WtP+krk9NNGtj7igk21DhcseJrKBpG7ll9O/Wmq1L8BwW+ypuJS+kHV61jRNYMFJY48Pt11Zoukgqu94kzrhz+KET8q463zlyu/Kp2z5yWI8xwvOtuyjosszfm6/YFQTFdhcmHY3X1yz44NaVG9FPev1QPoPmI7K3Jqa0Q8Q5kQTbe/KrB0eyRpXtyAaShOEeiS2ypmFAC81/m4mjuTd24yAjBcTIfBYzjxwjPbKfv+OYKahDwJP1b7EhsM+Sgu48wQ+pp6wc8TYCOkiRR1pKeb3kaxpQGzlq7VNbWHFPw9TDiyCIEnr8T5eiJtzJJ0U0iIfqN5WHk7iHiNK4Y4TvmdF4f6UyeMTHvaprvzUZI8il5wvoCgIiRUY7qvv5V/KL4ZWHN6Y3EEvQmP4WDo3Wx5IFW8C1gkyFv8lQ1COSNYMPog6RLAI0rNvKZjvc4baWwcHmk/fM92X19F2Y0DArqLFFUTJVE5bUQXQexiUO1e8IL07wqY=",
		"nonce": "d8816e8d6dca4409b790a4bcaa25c621"
	}
}
```

### **返回示例 (Return example)**

在成功接收回調請求後，請返回 `success` 以通知通知伺服器。通知伺服器收到 `success` 後，通知將停止。否則，通知將以 0s/15s/30s/3m/10m/20m/30m/60m/3h/6h 的頻率發送 10 次。