01
梳理使用情境
確認由誰發起付款、涉及哪些系統，以及產品如何判定付款成功。
支付請求流程REFERENCE / 01
01POST/payment-intents
02驗證請求
03回傳狀態
規劃範例JSON
整合流程示意
本頁端點與範例僅供概念說明，不代表已發布的 API 規格、正式憑證或可直接用於正式環境的整合文件。
整合流程
按步驟規劃實作
02
選擇工作流程
規劃結帳、收款、風險檢視及支付狀態如何連結客戶旅程。
03
串接事件
規劃應用程式如何接收狀態變更，並與內部紀錄核對。
04
檢視例外情況
定義如何處理重試、逾時、重複通知及人工檢視。
規劃檢查清單
整合概念
定義正式 API 規格時，可將以下主題作為與實作團隊討論的檢查清單。
支付意圖
與付款嘗試相關的業務脈絡及金額。
冪等性
協助整合流程安全處理重複送出的請求識別碼。
支付狀態
應用程式需要與自身訂單生命週期核對的狀態。
Webhook 事件
需要驗證、確認接收並安全處理的事件通知。
對帳
將支付紀錄與內部帳本或訂單系統進行核對的流程。
錯誤處理
妥善回應驗證失敗、網路問題及結果不確定等情況。
JSON 範例
概念性支付請求
以下 JSON 欄位僅示意支付流程可能需要的資訊。實作前請依正式服務規格確認實際結構及驗證方式。
正式導入前請確認
請依最終整合文件確認端點網址、驗證方式、支援幣別、事件簽章、重試規則及結算流程。
payment-request.json僅供示意
{
"reference": "ORDER_REFERENCE",
"amount": {
"value": "AMOUNT_TO_CONFIRM",
"currency": "CURRENCY_CODE"
},
"returnUrl": "YOUR_CHECKOUT_RETURN_URL",
"metadata": {
"source": "YOUR_APPLICATION"
}
}請依正式規格確認欄位application/json
規劃整合
聯絡業務討論整合需求
分享使用情境及涉及的系統，進一步釐清整合範圍。