環境與測試

兩個環境

	測試環境	正式環境
API	https://payment-api.testing.oen.tw	https://payment-api.oen.tw
結帳頁	https://{網域名稱}.testing.oen.tw/checkout/{id}	https://{網域名稱}.oen.tw/checkout/{id}
CRM（產生 token、設定通知網址）	https://{網域名稱}.testing.oen.tw/crm	https://{網域名稱}.oen.tw/crm
token	測試環境 CRM 產生	正式環境 CRM 產生
固定 IP 白名單	沒有	有，要先申請，見固定 IP 白名單
付款通知	會實際送到你設定的網址	會
實際扣款	不會，連到收單機構的測試系統	會

• 兩個環境的 token 不能互用，用錯會回 401 A0001。
• 兩個環境的通知網址要分別在各自的 CRM 設定。
• 測試環境帳號與網域需要請應援開設，請商家聯絡業務人員。

各種頁面網址

API 只回傳 id，結帳頁網址要自己組：

API	結帳頁路徑	有效時間
POST /checkout	/checkout/{id}	5 分鐘
POST /checkout-subscription	/checkout/subscription/{id}	5 分鐘
POST /checkout-schedule	/checkout/schedule/{id}	5 分鐘
POST /checkout-token	/checkout/subscription/create/{id}	10 分鐘

有效時間從呼叫 API 的那一刻起算，不是從消費者打開頁面起算。

測試付款

測試環境連到收單機構的測試系統，不會真的扣款。

測試卡號

付款成功用 4242 4242 4242 4242，到期日填未來的月份、安全碼任意 3 碼。3D 驗證與付款失敗的卡號、各欄位的填法，見測試卡號。

• 金額不影響結果。 舊版 Postman 文件寫的「金額大於 100 元會成功、小於 100 元會失敗」不是應援的規則，請不要依賴。用 4242 4242 4242 4242 付 100 元以下也會成功。
• 網域關閉國外卡，或收單設定和一般網域不同時，結果會和測試卡號頁不同，請聯絡應援確認測試網域的設定。
• 到期日請填未來的日期。結帳頁會直接擋下已過期的卡片。
• 要測試逾時，讓結帳頁停留超過 5 分鐘即可，頁面會導回 failureUrl?payment_error=V0002。
• 超商代碼、ATM 沒有測試卡號。取號後，到測試環境 CRM「金流管理」→「金流列表」點進這筆交易，在「模擬付款結果（測試環境限定）」按「模擬付款成功」或「模擬付款失敗／過期」，之後會依真實的付款結果處理，也會送出付款通知（charged，或 failed 加 PAYMENT_EXPIRED）。只有待付款的交易會出現這兩個按鈕，帳號要有交易退款權限；正式環境沒有這個功能。

測試付款通知

• 測試環境會把付款通知送到你在測試環境 CRM 設定的網址。
• 本機開發可以用 tunnel 工具取得公開的 https 網址。網址必須是 https、使用 443 port，而且可以從網際網路連到。
• 付款通知沒有「重送」按鈕，也沒有測試事件 API。要重複測試，請再建立一筆交易付款。

換到正式環境

1. 在正式環境 CRM 產生 token，更新伺服器設定。
2. 在正式環境 CRM 設定通知網址。
3. 把 API 網址與結帳頁網址中的 .testing 拿掉。
4. 確認已完成固定 IP 白名單申請。
5. 走一遍上線檢查清單。