【技術FAQ】使用「模擬付款」功能確認ReturnURL接收功能 / Using the “Simulated Payment” Function to Verify ReturnURL Reception

使用「模擬付款」功能確認ReturnURL接收功能

繁中 | ENG

綠界提供「模擬付款」功能,您可以使用此功能確認自己的ReturnURL可以正常接收綠界回傳的交易結果通知。

※「直播主收款網址」不支援模擬付款功能 ※

步驟一: 測試環境建立訂單

建立一筆ATM訂單,並完成取號。

步驟二: 後台觸發模擬付款功能

1. 請登入綠界廠商後台 ( 點我 )。

2. 依序進入: 一般訂單查詢 > 全方位金流訂單 > 廠商訂單編號 > 查詢。

3. 點選「模擬付款」按鈕。

按下「模擬付款」按鈕後,綠界會發送「模擬付款成功」通知至您建立訂單時所填的ReturnURL,目的是確認貴司設定的ReturnURL是否能收到綠界通知。

※ 請注意,此通知並非實際付款,不會變更訂單狀態。※

回傳參數中,「SimulatePaid=1」表示此通知為模擬付款,請勿變更訂單狀態,以免造成損失,網頁上方也會有Alert提醒。

再次點選「確定」後,綠界就會發送模擬付款通知。

►若ReturnURL有收到綠界回傳付款通知,且ReturnURL有回傳1|OK訊息給綠界,頁面會顯示如下訊息。

►若綠界並未收到您的ReturnURL回傳1|OK訊息,便會顯示如下訊息。

若出現上述提示,請檢查ReturnURL是否有接收到綠界回傳的模擬付款通知:

※ 若ReturnURL「未」收到綠界回傳通知:

►請確認您設定的 ReturnURL網址已經開放對外,且從貴公司的網域之外也可以通知的到。

►請確認貴公司的 Server 是否有開通防火牆,以避免付款通知被防火牆阻擋。

►因資安政策規定,綠界僅提供 80 或 443 PORT,若您的ReturnURL有指定其他PORT,會無法接收綠界回傳通知。

※ 若ReturnURL「有」收到綠界回傳通知,但卻未正確回傳1|OK:

►請確認您的 ReturnURL於收到綠界通知後,是否有正確回傳1|OK給綠界。

►請確認正確回傳的格式: 1|OK   ( 常見錯誤: 1OK、OK )。

Using the "Simulated Payment" Function to Verify ReturnURL Reception

繁中 | ENG

ECPay provides a “Simulated Payment” function that allows you to verify if your ReturnURL can successfully receive transaction result notifications sent by ECPay.
※The “Streamer Payment URL” does not support the simulated payment function.※
 
 
Step 1: Create an Order in the Test Environment
 
Create an ATM order and complete the number generation process.
 
 
Step 2: Trigger the Simulated Payment Function in the ECPay Stage Dashboard
 
1.Log in to the ECPay Merchant Backend (Click Here).
 
2.Navigate to:  General Order Query(一般訂單查詢) > All-In-One Payment Orders(全方位金流訂單) > Merchant Order Number(廠商訂單編號) > Query(查詢).
 
3.Click the “Simulated Payment(模擬付款)” button.
 
 
Once you click the “Simulated Payment” button, ECPay will send a “Simulated Payment Success” notification to the ReturnURL you specified when creating the order. The purpose of this function is to verify whether your configured ReturnURL can properly receive ECPay notifications.
 
Important Notes:
This notification is for simulation purposes only and does not represent an actual payment. It will not change the order status.
In the returned parameters, SimulatePaid=1 indicates that this is a simulated payment notification. Please do not change the order status upon receiving this notification to avoid any losses.
An alert message will also appear on the webpage as a reminder.
 
 
After clicking “Confirm” again, ECPay will send the simulated payment notification.
If the ReturnURL successfully receives the payment notification and correctly responds with 1|OK to ECPay, the page will display the following success message.
 
 
If ECPay does not receive the 1|OK response from your ReturnURL, the page will display the following failure message.
 
Troubleshooting:
 
If the ReturnURL did not receive ECPay’s notification:
►Ensure that the ReturnURL you configured is accessible externally and can be reached from outside your company’s domain.
►Check whether your server has a firewall enabled. If not, it might block the payment notification.
►Due to security policies, ECPay only supports PORT 80 or PORT 443. If your ReturnURL specifies a different port, it will not be able to receive notifications from ECPay.
 
If the ReturnURL received ECPay’s notification but did not correctly respond with 1|OK:
►Verify that your ReturnURL correctly responded with 1|OK after receiving the ECPay notification.
►Ensure the response format is correct: 1|OK. (Common errors: 1OK, OK).
 

Copyright © Green World FinTech Service Co., Ltd. All rights reserved.